What is WipperSnapper
WipperSnapper is a firmware designed to turn any WiFi-capable board into an Internet-of-Things device without programming a single line of code. WipperSnapper connects to Adafruit IO, a web platform designed (by Adafruit!) to display, respond, and interact with your project's data.
Simply load the WipperSnapper firmware onto your board, add credentials, and plug it into power. Your board will automatically register itself with your Adafruit IO account.
From there, you can add components to your board such as buttons, switches, potentiometers, sensors, and more! Components are dynamically added to hardware, so you can immediately start interacting, logging, and streaming the data your projects produce without writing code.
If you've never used WipperSnapper, click below to read through the quick start guide before continuing.
Wiring
First, wire up a NeoRGB Stemma component to your board following one of the methods below, using a signal/data pin supporting PWM (see the pinouts page on your board's learn guide).
Your wiring will differ depending on how many total amps will be used across all three RGB channels (STEMMA / JST-PH connectors are rated for 2 Amps continuous load).
Here is how you'll wire the breakout to an Adafruit ESP32 Feather V2 using pin D14 and single RGB LED using less than 2A total used across all three RGB channels.
- Feather 3V to NeoRGB JST PH VIN (red wire)
- Feather GND to NeoRGB JST PH GND (black wire)
- Feather pin 14 to NeoRGB JST PH SIG (white wire)
- NeoRGB RED to RGB LED red anode (pink wire)
- NeoRGB GRN to RGB LED green anode (green wire)
- NeoRGB BLU to RGB LED blue anode (blue wire)
- NeoRGB GND to RGB LED cathode (black wire)
Here is how you'll wire the breakout to an Adafruit ESP32 Feather V2 using pin D14 and a 12V RGB LED strip with more than 2A total used across all three RGB channels:
- Feather GND to NeoRGB JST PH GND (black wire)
- Feather pin 14 to NeoRGB JST PH SIG (white wire)
- Power supply positive pin to NeoRGB terminal block VIN (red wire)
- Power supply negative pin to NeoRGB terminal block GND (black wire)
- NeoRGB RED to RGB strip red channel (pink wire)
- NeoRGB GRN to RGB strip green channel (green wire)
- NeoRGB BLU to RGB strip blue channel (blue wire)
- NeoRGB VIN to RGB strip VIN (red wire)
Usage
Connect your board to Adafruit IO Wippersnapper and navigate to the WipperSnapper board list.
On this page, select the WipperSnapper board you're using to be brought to the board's interface page.
If you do not see your board listed here - you need to connect your board to Adafruit IO first.
On the device page, quickly check that you're running the latest version of the WipperSnapper firmware.
The device tile on the left indicates the version number of the firmware running on the connected board.
- If the firmware version is green with a checkmark - continue with this guide.
- If the firmware version is red with an exclamation mark "!" - update to the latest WipperSnapper firmware on your board before continuing.
Next, make sure the component is plugged into your board, any external components are correctly wired and powered, and then finally that your board is powered too.
Now you're ready to add your component to your WipperSnapper device.
Click the New Component button or the + button to bring up the component picker.
Adafruit IO supports a large amount of components. To quickly find your sensor, type NeoRGB
into the search bar, then select the NeoRGB Stemma component.
On the component configuration page, the NeoRGB's component settings should be listed. Select the NeoPixel Pin that has the NeoRGB / STEMMA signal wire attached (D12 here), and leave Number of Pixels set to 1.
The Color Order option is specific to each RGB strip or your wiring. This option will tell the Feather which signals to match up to Red / Green / Blue, and as a result for each color in the palette. Here the value is set to RGB as that matches the LED strip's wiring.
Finally Brightness is an overall maximum brightness for the LEDs, which can also be useful to limit the current. This will be used to scale the components chosen color and brightness via the Color Picker.
For this example, set the Brightness to 255, which is full brightness.
Your device interface should now show the NeoRGB component you created.
Clicking one of the colors in the Color Picker, using the color dropper, and adjusting the Brightness slider will cause WipperSnapper to automatically send Hexadecimal color values to the component via Adafruit IO.
To view the data that has been previously sent to the component, click on the graph next to the component name.
Here you can see the feed history and edit things about the feed such as the name, privacy, webhooks associated with the feed and more. If you want to learn more about how feeds work, check out this page.
Page last edited March 11, 2024
Text editor powered by tinymce.