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

To easily connect the Simple Soil Sensor to your microcontroller board we recommend using a JST SH Compatible (1mm Pitch) 3 Pin to Premium Male Headers Cable although any method is fine.

First, wire up a Simple Soil Sensor to your board exactly as follows.

Here is an example of the Simple Soil Sensor connected to an Adafruit ESP32 Feather V2.

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.

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 Soil into the search bar, then select the Simple Soil Sensor component.

On the component configuration page, the Soil sensor pin should be selected along with the sensor's settings.

Choose A2 from the Pin dropdown, or an appropriate analog input pin for your board (matching your wiring).

The Return Interval allows you to set the component to report each change (with some hysteresis), or to report the current value on a schedule (following the poll period).

For this example, set the Return Interval to Periodically, and Period to 5 seconds.
Later adjust this using the settings cog for the component, and pick a longer period.

Finally the Return Type selects whether to return the Raw Analog Value, or the Voltage.
Pick either one, the Raw value is easier to work with, but the Voltage more familiar.

The dialog should look very similar to this before clicking 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.

To view the data that has been logged from the sensor, click on the graph next to the sensor 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.

In this graph I've switched the Return Type from Raw Analog Value (start ~42000), to Voltage (middle portion ~2.2volts), and back again, to illustrate the difference in value ranges.