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.
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.
// Adafruit IO WipperSnapper Beta
//
//
// NOTE: This software is a BETA release and in active development.
// Please report bugs or errors to
// https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/issues
//
// This sketch is for devices which lack USB-MSD or LittleFS support such
// as the Arduino MKR WiFi 1010, Arduino Nano 33 IoT.
//
// Adafruit invests time and resources providing this open source code.
// Please support Adafruit and open source hardware by purchasing
// products from Adafruit!
//
// Brent Rubell for Adafruit Industries, 2021
//
// All text above must be included in any redistribution.
#include "Wippersnapper_Networking.h"
/************************ Adafruit IO Config *******************************/
// Visit io.adafruit.com if you need to create an account,
// or if you need your Adafruit IO key.
#define IO_USERNAME "YOUR_AIO_USERNAME"
#define IO_KEY "YOUR_AIO_KEY"
/**************************** WiFi Config ***********************************/
#define WIFI_SSID "YOUR_WIFI_SSID"
#define WIFI_PASS "YOUR_WIFI_PASSWORD"
#include "Wippersnapper_Networking.h"
Wippersnapper_WiFi wipper(IO_USERNAME, IO_KEY, WIFI_SSID, WIFI_PASS);
void setup() {
// Provisioning must occur prior to serial init.
wipper.provision();
Serial.begin(115200);
// while (!Serial) delay(10);
wipper.connect();
}
void loop() { wipper.run(); }
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!
