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 an Adafruit STEMMA Reflective Photo Interrupt Sensor (TCTR1000) to your board exactly as follows.
Here is an example of the TCTR1000 wired to an Adafruit ESP32 Feather V2 using a STEMMA JST PH 2mm 3-Pin to Male Header Cable (no soldering required)
- Board 3V to sensor VIN (red wire on STEMMA)
- Board GND to sensor GND (black wire on STEMMA)
- Board A0 to sensor SIG (white wire on STEMMA)
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.
With the sensor wired and device up-to-date, you're ready to add the sensor component to your board.
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 TCTR
into the search bar, then select the TCTR1000 component.
On the component configuration page, the TCTR1000's pin option should be listed along with the sensor's settings. Set the pin to something appropriate for a digital input, for this example use the pin labelled D26 / (A0).
The Return Interval setting is specific to each sensor's measurements and allows toggling between periodic or reactive triggering.
The Return Interval's periodic option controls how often the Feather reads the TCTR1000 sensor and sends data to Adafruit IO. You can select intervals from every 30 seconds to every 24 hours. Another choice is "On Change." It immediately sends data to Adafruit IO when the sensor changes state.
For this example set the Return Interval to On Change, then click Create Component.
Your device interface should now show the sensor components you created. After the interval you configured elapses, WipperSnapper will automatically read values from the sensor(s) and send them to Adafruit IO.
Why Did I get a "Throttle Warning"?
This happens when you exceed the data limit. Adafruit IO's free plan allows 30 data points per minute, compared to 60 data points per minute IO Plus (Paid) plan.
If this happens to you, don't worry! Your device will resume sending data once it's back under the limit.
To view the logged data from the sensor, click the graph by the sensor's name.
Here, on the Feed Page, you can view and edit a feed's history, name, privacy, and related webhooks. If you want to learn more about how feeds work, check out this page.
Page last edited June 12, 2024
Text editor powered by tinymce.