# Quickstart: Adafruit IO WipperSnapper ## Welcome to WipperSnapper ![](https://cdn-learn.adafruit.com/assets/assets/000/103/170/medium800/adafruit_products_devicepage.png?1624896673) 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](https://io.adafruit.com/), a web platform designed ([by Adafruit!](https://www.adafruit.com/about)) 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. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/208/medium800/sensors_Temp___Humidity_Sensor_Banner_v1_2021_12_%281%29.jpg?1639171300) Warning: Adafruit IO and WipperSnapper are in  **beta ** and are actively being developed to add functionality, hardware, and fix bugs. **We encourage you to try out the WipperSnapper firmware**  with the understanding that it is not final release software and is still in development. If you encounter any bugs, glitches, or difficulties during the beta period, or in this guide, [please file an issue on the Adafruit IO support page](http://io.adafruit.com/support). # Quickstart: Adafruit IO WipperSnapper ## Installing WipperSnapper ![](https://cdn-learn.adafruit.com/assets/assets/000/104/837/medium800/sensors_boardspread.jpg?1632501539) ## Works with Adafruit IO + WipperSnapper Firmware If you have an Adafruit IO account, you can visit [https://io.adafruit.com/wippersnapper/new](https://io.adafruit.com/wippersnapper/new) to browse the boards which have firmware built for WipperSnapper. ![](https://cdn-learn.adafruit.com/assets/assets/000/113/154/medium800/sensors_boards.png?1657651221) ### Can I add a new development board to Adafruit IO? You can add a new board to Adafruit IO and make a WipperSnapper firmware image for it by following this guide: [https://learn.adafruit.com/how-to-add-a-new-board-to-wippersnapper](https://learn.adafruit.com/how-to-add-a-new-board-to-wippersnapper) ### The development board I own is not on this list We're actively developing Adafruit IO Wippersnapper and will be adding new boards over time. Follow the [Adafruit Blog](https://blog.adafruit.com/) and [@AdafruitIO](https://twitter.com/adafruitio) on Twitter to keep updated. You can also add a feature request on GitHub for [a new Board](https://github.com/adafruit/Wippersnapper_Boards/issues/new?template=board-request.md), or [anything else!](https://github.com/adafruit/Adafruit_Wippersnapper_Arduino/issues/new?template=feature_request.md) # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit Feather HUZZAH32 # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit ESP32 Feather v2 # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit ESP32-S2 Feather # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit ESP32-S2 TFT Feather # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit QT Py ESP32 Pico # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit QT Py ESP32-S2 # Quickstart: Adafruit IO WipperSnapper ## Install WipperSnapper on Adafruit QT Py ESP32-S3 # Quickstart: Adafruit IO WipperSnapper ## Installing WipperSnapper on ESP8266 # Quickstart: Adafruit IO WipperSnapper ## WipperSnapper Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/104/839/medium800/sensors_device.jpg?1632501715) Ok - you've connected your board to WipperSnapper. _Now what?_ This page will give you a quick tour of Adafruit IO WipperSnapper and its core features. ## WipperSnapper Device List ![](https://cdn-learn.adafruit.com/assets/assets/000/103/179/medium800thumb/adafruit_products_Kapture_2021-06-28_at_15.14.52.jpg?1624907789) The Device List page provides a list of the devices you've connected to Adafruit IO WipperSnapper along with their connection status. Think of it as a virtual inventory for your boards!  You can visit this page at any time by navigating to [https://io.adafruit.com/wippersnapper](https://io.adafruit.com/wippersnapper). ## Wippersnapper Device Page ![](https://cdn-learn.adafruit.com/assets/assets/000/103/075/medium800/adafruit_products_devicepage.png?1624636103) Clicking on a device from the Devices List page will bring you to its device page. This page is an interface to configure and interact with anything physically connected to your device. You may think of it as the state of your device at any given time.  When you register a device for the first time, this page will be empty, it's a clean slate! ## WipperSnapper Components  ![](https://cdn-learn.adafruit.com/assets/assets/000/103/180/medium800thumb/adafruit_products_Kapture_2021-06-28_at_15.17.58.jpg?1624907893) A "_component_" in WipperSnapper denotes anything which is physically connected to your hardware. This can include sensors, buttons, LEDs, NeoPixels, displays, and more! When you click **New Component,** your hardware will _automatically_ connect to and configure the component using the settings you specified. No coding required!  Additionally, **a component also sets up a unique [Adafruit IO feed](https://learn.adafruit.com/adafruit-io-basics-feeds) to store the component's data stream on the web.** ![](https://cdn-learn.adafruit.com/assets/assets/000/103/168/medium800thumb/adafruit_products_Kapture_2021-06-28_at_12.01.13.jpg?1624896488) ### **Nope!** WipperSnapper remembers each component's configuration for each of your boards. The "state" of your board's configuration is saved to its device page. When you re-connect a board to WipperSnapper, it will automatically re-configure every component listed on the Device Page. The most recent value stored on each component's feed will be sent to the device. ## I do not see my the component I want to use listed in the component picker pop-up We're actively working towards adding more components and component types to Adafruit Wippersnapper. We also gladly take community contributions to Adafruit IO - [You can add your own component by following this guide.](https://learn.adafruit.com/how-to-add-a-new-component-to-adafruit-io-wippersnapper) # Quickstart: Adafruit IO WipperSnapper ## Blink a LED! ![](https://cdn-learn.adafruit.com/assets/assets/000/103/055/medium800thumb/adafruit_products_led-300.jpg?1624566111) Getting something to blink is the first step for most hardware projects. We'll start learning WipperSnapper by adding a [LED](https://learn.adafruit.com/all-about-leds) component to your board and blinking it!  ## Component Wiring Most development boards include a built-in LED which you don't need to wire up.  On the Adafruit FunHouse, this LED is found below the display, and slightly to the right. For other development boards, refer to the board's wiring diagram for the location of the built-in LED or wire up an externally connected LED. ![adafruit_products_Pasted_Image_6_25_21__11_03_AM.png](https://cdn-learn.adafruit.com/assets/assets/000/103/068/medium640/adafruit_products_Pasted_Image_6_25_21__11_03_AM.png?1624633437) ## Add a LED Component First, navigate to the WipperSnapper [device list](https://io.adafruit.com/wippersnapper) and select the board you'd like to use. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/744/medium800/sensors_boards.png?1631910116) On the device page, next to the device's name, there should be a green "Online" badge indicating that the device is connected to Adafruit IO. ![](https://cdn-learn.adafruit.com/assets/assets/000/103/056/medium800/adafruit_products_IO_-_WipperSnapper.png?1624566552) ### First, verify your Wireless Network's connectivity by navigating to [https://io.adafruit.com/wippersnapper](https://io.adafruit.com/wippersnapper) from your browser. If your wireless network is up and you can access Adafruit IO, [please contact Adafruit IO support](http://io.adafruit.com/support) for further troubleshooting steps. **Click the + New Component button** to bring up the component picker.  ![](https://cdn-learn.adafruit.com/assets/assets/000/103/057/medium800thumb/adafruit_products_Kapture_2021-06-24_at_16.33.59.jpg?1624566876) From the component picker, **click the LED**. ![](https://cdn-learn.adafruit.com/assets/assets/000/103/058/medium800/adafruit_products_IO_-_WipperSnapper.png?1624566966) Next, we're going to configure the LED component. **Set the component's name**. ![](https://cdn-learn.adafruit.com/assets/assets/000/103/059/medium800/adafruit_products_IO_-_WipperSnapper.png?1624567350) Then, **open the LED Pin dropdown and select the pin to which the LED is physically connected**. ![](https://cdn-learn.adafruit.com/assets/assets/000/103/060/medium800/adafruit_products_IO_-_WipperSnapper.png?1624567427) Once you've configured the LED, **click Create Component**.  ![](https://cdn-learn.adafruit.com/assets/assets/000/103/061/medium800thumb/adafruit_products_Kapture_2021-06-24_at_16.45.21.jpg?1624635369) A new toggle button "component" should appear on the device page. **Click the button to toggle the LED!** ![](https://cdn-learn.adafruit.com/assets/assets/000/103/067/medium800thumb/adafruit_products_Kapture_2021-06-25_at_10.14.19.jpg?1624630470) _Wait...what just happened?_ When you clicked _"Create Component"_ Adafruit IO WipperSnapper sent a message to your board to configure the LED using the settings you configured. It also created a new [Adafruit IO Feed](https://learn.adafruit.com/adafruit-io-basics-feeds) for storing the component's history and saving its state. Toggling the button sends a _"toggle the LED"_ message to the device. This is the core of how digital outputs work in Adafruit IO WipperSnapper. # Quickstart: Adafruit IO WipperSnapper ## Troubleshooting Info: **Did you know?** WipperSnapper devices output debug logging over the serial port (USB Serial Device), reporting a wealth of troubleshooting information, and you can monitor it to see what's happening. ## WipperSnapper RGB Status Light Most WipperSnapper-capable boards have a single NeoPixel or DotStar RGB LED on the board. During the boot process, the LED is used to signal the hardware's status. Here's what the colors and blinking means: - **YELLOW Blinking** - There is a new **secrets.json** file on the **WIPPER** drive. Edit this file to contain your credentials and RESET the device for the changes to take effect. - **PINK ** - Connecting to Network. - If the device reboots while displaying this color, there's an issue connecting to the wireless network you specified in **secrets.json** _._ - **BLUE** - Connecting to Adafruit.io MQTT Broker - If the device reboots while displaying this color, please verify your Adafruit.io username and key in the  **secrets.json** file_._ - **GREEN Solid - ** Connected to Network and Adafruit IO. - **YELLOW Solid - ** Registering and configuring your hardware with WipperSnapper. - **GREEN Blinking (3x) -** Bootup complete, you can proceed to use your device with the WipperSnapper website. ![](https://cdn-learn.adafruit.com/assets/assets/000/104/745/medium800/sensors_ledstates.drawio.png?1631912120) ## Encountering issues? **If you are having trouble with your hardware** , technical support is provided in the Adafruit customer forums for all Adafruit customers by our dedicated team of engineers and staff. To get help, [post a new topic on the WipperSnapper forum](https://forums.adafruit.com/viewforum.php?f=66). **If you are having a problem with the WipperSnapper website** - vist [http://io.adafruit.com/support](http://io.adafruit.com/support) and click  **Contact Adafruit IO Support**. ## Adafruit IO Data Rate If you are using [Adafruit IO Plus](https://io.adafruit.com/plus), you will be able to send 60 data points per minute to Adafruit IO. If you are using the free Adafruit IO account, you will be able to send 30 data points per minute. Sending more than this will result in your account temporarily timing out ("throttled").  This means that if you're using a Free Adafruit IO account, you will need to be more conscious of how you set up your components. We suggest IO Free users configure their components to send data on a periodic basis, rather than immediately.  ## Adafruit IO Feed Limit Free Adafruit IO accounts are limited to ten total components and up to two Wippersnapper devices per account. Adafruit IO Plus accounts do not have a limit on the number of devices that may connect to Wippersnapper or feeds. However, you must adhere to sending 60 data points per minute, across all your WipperSnapper devices. If this data rate limit is too low, [we offer upgrades to the Adafruit IO Plus plan](https://io.adafruit.com/blog/notebook/2019/04/17/io-plus-plan-upgrades/) to increase your data rate limit.  ## Featured Products ### Adafruit FunHouse - WiFi Home Automation Development Board [Adafruit FunHouse - WiFi Home Automation Development Board](https://www.adafruit.com/product/4985) Home is where the heart is...it's also where we keep all our electronic bits. So why not wire it up with sensors and actuators to turn our house into an electronic wonderland. Whether it's tracking the environmental temperature and humidity in your laundry room, or notifying you when... Out of Stock [Buy Now](https://www.adafruit.com/product/4985) [Related Guides to the Product](https://learn.adafruit.com/products/4985/guides) ### Adafruit Metro M4 Express AirLift (WiFi) - Lite [Adafruit Metro M4 Express AirLift (WiFi) - Lite](https://www.adafruit.com/product/4000) Give your next project a lift with _AirLift_ - our witty name for the ESP32 co-processor that graces this Metro M4. You already know about the  **Adafruit Metro M4**  featuring the  **Microchip ATSAMD51** , with it's 120MHz Cortex M4 with... In Stock [Buy Now](https://www.adafruit.com/product/4000) [Related Guides to the Product](https://learn.adafruit.com/products/4000/guides) ### Adafruit PyPortal - CircuitPython Powered Internet Display [Adafruit PyPortal - CircuitPython Powered Internet Display](https://www.adafruit.com/product/4116) **PyPortal** , our easy-to-use IoT device that allows you to create all the things for the “Internet of Things” in minutes. Make custom touch screen interface GUIs, all open-source, and Python-powered using tinyJSON / APIs to get news, stock, weather, cat photos,... Out of Stock [Buy Now](https://www.adafruit.com/product/4116) [Related Guides to the Product](https://learn.adafruit.com/products/4116/guides) ### Adafruit IO+ Subscription Pass – One Year [Adafruit IO+ Subscription Pass – One Year](https://www.adafruit.com/product/3792) The all-in-one Internet of Things service from Adafruit you know and love is now _even better_ with IO+. The 'plus' stands for MORE STUFF! More feeds, dashboards, storage, speed. Power up your [Adafruit IO](https://io.adafruit.com/) with the $99 pass for 1 year of the... In Stock [Buy Now](https://www.adafruit.com/product/3792) [Related Guides to the Product](https://learn.adafruit.com/products/3792/guides) ### Adafruit IO+ 1 Year Subscription Card [Adafruit IO+ 1 Year Subscription Card](https://www.adafruit.com/product/3980) It's the Internet of the Things! [Adafruit IO+](https://io.adafruit.com/plus) is the easiest way to stream, log, and interact with your data. Whether you're interesting in datalogging or communicating with your microcontroller over the web, Adafruit IO is our cloud... In Stock [Buy Now](https://www.adafruit.com/product/3980) [Related Guides to the Product](https://learn.adafruit.com/products/3980/guides) ## Related Guides - [Adafruit PyPortal - IoT for CircuitPython](https://learn.adafruit.com/adafruit-pyportal.md) - [Adafruit Metro M4 Express AirLift (WiFi)](https://learn.adafruit.com/adafruit-metro-m4-express-airlift-wifi.md) - [Adafruit FunHouse](https://learn.adafruit.com/adafruit-funhouse.md) - [PyPortal Quarantine Clock](https://learn.adafruit.com/pyportal-quarantine-clock.md) - [Upgrading AirLift ESP32 Firmware](https://learn.adafruit.com/upgrading-esp32-firmware.md) - [Memento Photo Capture with itsaSNAP](https://learn.adafruit.com/memento-photo-capture-with-itsasnap.md) - [MQTT in CircuitPython](https://learn.adafruit.com/mqtt-in-circuitpython.md) - [A Floppy Thumb Drive with a Color File Icon Display](https://learn.adafruit.com/a-floppy-thumb-drive-with-a-color-file-icon-display.md) - [Tiny Autostereogram Construction Kit](https://learn.adafruit.com/tiny-autostereogram-construction-kit.md) - [Using Python on Windows 10](https://learn.adafruit.com/using-python-on-windows-10.md) - [PyPortal Voice Controlled Smart Switch and Time Display](https://learn.adafruit.com/pyportal-voice-controlled-smart-switch-and-time-display.md) - [Monitor Your Greenhouse with a No-Code Environmental Sensor](https://learn.adafruit.com/monitor-your-greenhouse-with-a-no-code-environmental-sensor.md) - [PyPortal ISS Tracker](https://learn.adafruit.com/pyportal-iss-tracker.md) - [Network Connected RGB Matrix Clock](https://learn.adafruit.com/network-connected-metro-rgb-matrix-clock.md) - [FunHouse Motion Detecting Lights with LIFX Bulbs](https://learn.adafruit.com/funhouse-motion-detecting-lighting-for-lifx-bulbs.md) - [PyPortal Weather Station](https://learn.adafruit.com/pyportal-weather-station.md) - [Stream Deck controlled RGB Message Panel using Adafruit IO](https://learn.adafruit.com/stream-deck-controlled-rgb-message-panel-using-adafruit-io.md)