WipperSnapper is a firmware (Arduino sketch) that connects boards with Components + Sensors in a no-code way. It's meant to be easy for beginners to start making things online quickly and simply, but sometimes we forget how much knowledge is expected.
It can be a tall order to know how to find the pin names for each board, but doubly so when you want to connect a seemingly easily sandwiched FeatherWing into the mix.
Today I followed this journey to test a newly supported E-ink FeatherWing display with one of our older boards, the Feather ESP32 v2 (Huzzah32), to replicate the MagTag setup which we know works well.
As I looked for the documentation link in the New Components dialog, I realised this was a step too far for many people to take confidently alone and I should probably document the journey.
It's a few steps to confidence, but mainly it's a few implicit steps and a couple of explicit ones:
- Use New Device button on io.adafruit.com to install WipperSnapper
- Follow all steps, use a Chromium based browser for Web Installer
- Once secrets are on the board and it's rebooted and you've been asked to name it then it should be online.
-
Find your Main boards pins (or use Docs link from IO Devices page)
- Locate the invoice/order and find the product name/id to then find the product webpage
- Goto the adafruit site and locate the same product page in the shop - confirm the info matches
- Scroll down the product page to the Learn Guides section, and the first is product learn guide.
- Each Product Learn guide has a pinout page (search learn.adafruit.com or use product page link)
- The pinout page has sections, dedicated to functionality / peripherals, with the main images at the top and highlighted versions throughout, so you might need to read relevant bits first then go back through the lot to catch any useful pointers (or at least keep referring back).
-
Find your "Component"'s pinout (e.g. a featherwing or sensor or button or neopixel strip)
- While you can follow the previous steps, especially if it's something adafruit don't sell (maybe find a similar one Adafruit does sell and read that product learn guide to gain confidence), it's easier to use the New Component dialog from the WipperSnapper device page on Adafruit IO, which has Documentation links for all components.
-
Create the component on WipperSnapper and select the correct Pins (sometimes automatic)...
- Start matching up the pins you've connected together physically, and if it's a featherwing (all pins connected physically) then use the product learn guide for the featherwing to establish which functions you intend to use and therefore which physical pins on the pinout page will be used.
- Select the New Component from list (in New Component Dialog), and continue to the Create Component page, where you select the pins and configuration options before clicking Create Component.
- The new component should be created and start reporting data, or be ready for you to send it some (like a colour for NeoPixels/DotStars, or some text for a Display). Test it
- Rejoice, then think about creating an Action that uses your data or sends some weather info to a display.
My Example: Feather ESP32 V2 (Huzzah32) mounted to the 2.9" E-Ink Featherwing
Stage 1 + 2, Install, get board online, then find pinout page
Install WipperSnapper then use the docs link from device page, followed by selecting the pinout page.
Or find learn guide via product page:
Read the pinout page, notice the nice SVG Pretty-Pins diagram near the top, and then read anything you feel relevant, in this case I'm connecting an SPI (MOSI/MISO/CS) screen, but you wouldn't know that yet necessarily, so just keep the page open for later.
Normally the board will have silk screen labels identifying the pins, but naming systems vary so use the Pretty Pins diagram as a good way to find the other labels. The Top and Bottom images of the board are also useful if yours is hidden while attached to a featherwing or embedded in a project.
Stage 2 Complete - Yay!
Stage 3 - Find pinout for your component
Use the New Component button from your WipperSnapper Device page, then search for the component to add (or a similar compatible sounding one), before using the Docs link in the component results.
Now visit the Pinouts page on the learn guide or read the datasheet if that is linked instead.
For my featherwing, there are a few models covered in the same page, so I ended up at this section: https://learn.adafruit.com/adafruit-2-9-eink-display-breakouts-and-featherwings/pinouts#featherwing-connections-3102326
Pinout located - Stage 3 Complete!
Stage 4 - Linking the pins together mentally and virtually
Your pins are probably already connected, you eager beaver, but if not that's fine too. Even if they are, double check the pins are capable of what you think and at the expected voltage levels.
Countless hours are wasted by using a pin that you think is "fine"/normal, and then turns out to be already in use for some documented purpose, or is not compatible (voltage/features) like a boosted 5volt output pin (D5 on itsybitsy).
Confirm the needed functionality (and therefore pins) on the components pinout page.
What does that mean? Well, are you connecting using one of two busses (data connnection types), either SPI or I2C, or maybe you want the buttons and display to be used on the same featherwing (like I do).
You'll need to ensure all the required pins are connected, and later in the Create Component dialog select those correctly. Optional pins are...optional, surprise!
Lets break it down:
4.1. Check the first functionality you care about (do one at a time, but they will probably share pins), so Display in this case.
4.1.1 View the highlighted pinout image and then compare with the pinouts for your main board, noting which is called which from the Main boards perspective.
Now with SPI, you normally don't get much choice about the main SPI pins [SCK and MOSI/MISO or PICO (Peripheral In, Controller Out) and POCI (Peripheral Out, Controller In)], as they are often fixed in the hardware of the mainboard, but all the others can vary.
4.2. To keep your eyes on the prize, go back to the New Component dialog, and click the component to be taken to the Create Component dialog.
Use the input boxes to guide which pins you need to identify:
So in order of the dialog, we need to identify:
- Data/Command pin for screen
- Reset pin for screen
- Chip Select pin for screen
- SRAM chip select pin
- Busy Pin for screen
Simply scan through the component pinout page for the items or similar terminology.
Those won't be our pin numbers, but using the description (and Silk Screen labels on PCB for the pins of the component) you can work out the answers.
Expect abbreviations, and don't be afraid to ask for help in the forums or discord if you are not sure.
In this case, we may leave some of the optional pins (Busy and Reset) unselected.
Checking the labels on the component pinout (highlighted in images below) you can see SRCS (SRAM Chip Select pin) and SDCS (SD card CS pin - not used ), along with ECS (E-Ink Chip Select pin) and DC (Data Command).
Those match up to 33, 15, 32, 14 on my feather.
So plug that into the Create Component dialog, then click the create button
That's about it! The component registers, and then you can send it text or whatever.
Now to add the buttons it's basically identical, pick a Push Button component in the New Component dialog, then select the pin identified from your product.
So that lines up with 13, 12, 27 on my main board.
The usual options for button components would be: On-Change rather than periodically, and Using a Pull-Up resistor (except ESP32 boot buttons are pull down).
Now that should be all the components configured - Stage 4 Complete!
5. Rejoice - You've unlocked new super powers, maybe put them to the test and go visit the Actions or Power-ups pages to explore the new world...
Here's a great example of using Actions on Adafruit IO to update a display using remote sensor data:
And as you've come this far, you get to see the hero image compositions by Sora (it's both a shame about the penguin instead of the logo, but equally strangely pleasing):
This page (How to "wire-up" anything (e.g. a featherwing Display) on WipperSnapper) was last updated on October 19, 2025.