# No-Code Battery Monitoring with WipperSnapper
## Overview
Low-cost Lithium Polymer batteries have revolutionized electronics - they're thin, they're light, they can be regulated down to 3.3V and they're easy to charge. On your phone, there's a little image of a battery cell that tells you the percentage of charge - so you know when you absolutely need to plug it in and when you can stay untethered.
The **Adafruit LC709203F LiPoly / LiIon Fuel Gauge and Battery Monitor ** do the same thing. Connect it to your [Lipoly or LiIon battery](https://www.adafruit.com/category/916) and it will let you know the voltage of the cell, It does the annoying math of decoding the non-linear voltage to get you a good percentage as well!
This guide will explore how to read your device's battery percent, code-free, with Adafruit IO WipperSnapper. It will also explore how to send an SMS alert when the battery is fully charged.
## 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](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.
## Parts
### Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM
[Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM](https://www.adafruit.com/product/5400)
One of our star Feathers is the [Adafruit HUZZAH32 ESP32 Feather](https://www.adafruit.com/product/3405) - with the fabulous ESP32 WROOM module on there, it makes quick work of WiFi and Bluetooth® projects that take advantage of Espressifs most popular chipset. Recently we had...
In Stock
[Buy Now](https://www.adafruit.com/product/5400)
[Related Guides to the Product](https://learn.adafruit.com/products/5400/guides)
### Adafruit LC709203F LiPoly / LiIon Fuel Gauge and Battery Monitor
[Adafruit LC709203F LiPoly / LiIon Fuel Gauge and Battery Monitor](https://www.adafruit.com/product/4712)
Low cost Lithium Polymer batteries have revolutionized electronics - they're thin, they're light, they can be regulated down to 3.3V and they're easy to charge. On your phone, there's a little image of a battery cell that tells you the percentage of charge - so you know when...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4712)
[Related Guides to the Product](https://learn.adafruit.com/products/4712/guides)
### Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh
[Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh](https://www.adafruit.com/product/3898)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of **400mAh** for a total of about 1.9 Wh. If you need a larger (or smaller!)...
Out of Stock
[Buy Now](https://www.adafruit.com/product/3898)
[Related Guides to the Product](https://learn.adafruit.com/products/3898/guides)
### STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long
[STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long](https://www.adafruit.com/product/4210)
This 4-wire cable is a little over 100mm / 4" long and fitted with JST-SH female 4-pin connectors on both ends. Compared with the chunkier JST-PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove.
Out of Stock
[Buy Now](https://www.adafruit.com/product/4210)
[Related Guides to the Product](https://learn.adafruit.com/products/4210/guides)
### Pink and Purple Woven USB A to USB C Cable - 1 meter long
[Pink and Purple Woven USB A to USB C Cable - 1 meter long](https://www.adafruit.com/product/5153)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers, and more. [If you want something just like it but for Micro B, we...](https://www.adafruit.com/product/4111)
Out of Stock
[Buy Now](https://www.adafruit.com/product/5153)
[Related Guides to the Product](https://learn.adafruit.com/products/5153/guides)
# No-Code Battery Monitoring with WipperSnapper
## Wiring
Info:
First, wire up an LC709203F to your board exactly as follows. Here is an example of the LC709203F wired to an [Adafruit ESP32 Feather V2](https://www.adafruit.com/product/5400) using I2C [with a STEMMA QT cable (no soldering required)](https://www.adafruit.com/product/4210). You can use a breadboard and wire if you wish, but a STEMMA QT cable makes it much easier.
- **Board 3V** to **sensor VIN (red wire on STEMMA QT)**
- **Board GND** to **sensor GND (black wire on STEMMA QT)**
- **Board SCL** to **sensor SCL (yellow wire on STEMMA QT)**
- **Board SDA** to **sensor SDA (blue wire on STEMMA QT)**
# No-Code Battery Monitoring with WipperSnapper
## WipperSnapper Setup
Warning:
## 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](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.
## Sign up for Adafruit.io
You will need an Adafruit IO account to use WipperSnapper on your board. If you do not already have one, head over to [io.adafruit.com](https://io.adafruit.com/) to create a _free_ account.
## Add a New Device to Adafruit IO
Log into your [Adafruit IO](https://io.adafruit.com/) account. Click the _New Device_ button at the top of the page.
After clicking New Device, you should be on the _board selector_ page. This page displays every board that is compatible with the WipperSnapper firmware.
In the board selector page's search bar, search for the _Feather ESP32 V2. _Once you've located the board you'd like to install WipperSnapper on,_ _click the _Choose Board_ button to bring you to the self-guided installation wizard.
Follow the step-by-step instructions on the page to install Wippersnapper on your device and connect it to Adafruit IO.
If the installation was successful, a popover should appear displaying that your board has successfully been detected by Adafruit IO.
Give your board a name and click "Continue to Device Page".
You should be brought to your board's device page.
## Feedback
Adafruit.io WipperSnapper is in **beta** and you can help improve it!
If you have suggestions or general feedback about the installation process - visit [https://io.adafruit.com/support](https://io.adafruit.com/support), click _"Contact Adafruit IO Support"_ and select _"I have feedback or suggestions for the WipperSnapper Beta"._
## Troubleshooting
If you encountered an issue during installation, please try the steps below first.
If you're still unable to resolve the issue, or if your issue is not listed below, get in touch with us directly at [https://io.adafruit.com/support](https://io.adafruit.com/support "https://io.adafruit.com/support"). Make sure to click _"Contact Adafruit IO Support"_ and select "_There is an issue with WipperSnapper. Something is broken!"_
###
First, make sure that you selected the correct board on the board selector.
Next, please make sure that you entered your WiFi credentials properly, there are no spaces/special characters in either your network name (SSID) or password, and that you are connected to a 2.4GHz wireless network.
If you're still unable to connect your board to WiFi, please [make a new post on the WipperSnapper technical support forum with the error you're experiencing, the LED colors which are blinking, and the board you're using.](https://forums.adafruit.com/viewforum.php?f=66)
###
Try hard-resetting your board by unplugging it from USB power and plugging it back in.
If the error is still occurring, please [make a new post on the WipperSnapper technical support forum with information about what you're experiencing, the LED colors which are blinking (if applicable), and the board you're using.](https://forums.adafruit.com/viewforum.php?f=66)
## "Uninstalling" WipperSnapper
WipperSnapper firmware is an application that is loaded onto your board. There is nothing to "uninstall". However, you may want to "move" your board from running WipperSnapper to running Arduino or CircuitPython. You also may need to restore your board to the state it was shipped to you from the Adafruit factory.
### Moving from WipperSnapper to CircuitPython
Follow the steps on the [Installing CircuitPython page](https://learn.adafruit.com/welcome-to-circuitpython/installing-circuitpython) to install CircuitPython on your board running WipperSnapper.
- If you are unable to double-tap the RST button to enter the UF2 bootloader, follow the _"Factory Resetting a WipperSnapper Board"_ instructions below.
Uploading this sketch will overwrite WipperSnapper. If you want to re-install WipperSnapper, follow the instructions at the top of this page.
### Moving from WipperSnapper to Arduino
If you want to use your board with Arduino, you will use the Arduino IDE to load _any_ sketch onto your board.
First, follow the page below to set up your Arduino IDE environment for use with your board.
[Setup Arduino IDE](https://learn.adafruit.com/adafruit-esp32-feather-v2/arduino-ide-setup)
Then, follow the page below to upload the "Arduino Blink" sketch to your board.
[Upload Arduino "Blink" Sketch](https://learn.adafruit.com/adafruit-esp32-feather-v2/blink)
Uploading this sketch will overwrite WipperSnapper. If you want to re-install WipperSnapper, follow the instructions at the top of this page.
### Factory Resetting a WipperSnapper Board
Sometimes, hardware gets into a state that requires it to be "restored" to the original state it shipped in. If you'd like to get your board back to its original factory state, follow the guide below.
[Factory Reset your Adafruit Feather HUZZAH ESP32-V2](https://learn.adafruit.com/adafruit-esp32-feather-v2/factory-reset)
# No-Code Battery Monitoring with WipperSnapper
## Adafruit IO Configuration
Assuming you have already gone through the WipperSnapper Setup page and connected your board to WipperSnapper, **[navigate to the WipperSnapper board list](https://io.adafruit.com/wippersnapper).**
On this page, **select the WipperSnapper board you just connected**.
- If you do not see your board listed - go back to the WipperSnapper Setup Page and make sure it registers with Adafrut.io
On the device page, quickly **check that your device is online and is 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 "X" -** [update to the latest WipperSnapper firmware](https://learn.adafruit.com/quickstart-adafruit-io-wippersnapper) on your board before continuing.
**Click the New Component button or the + button ** to bring up the component picker.
Primary: A lot of the feather boards have moved on to using the MAX17048/9 chips for Lipo battery monitoring.
Don't forget to attach a battery before attempting to initialise the MAX17048 so it behaves properly!
After the New Component dialog loads, search for and select the **LC709203F**.
On the component configuration page, the LC709203F's sensor address should be listed along with the sensor's settings.
The **Send Every** option is specific to each measurement. This option will tell the Feather how often it should read from each of the LC709203F's two measurements and send the data to Adafruit IO. Measurements can range from every 30 seconds to every 24 hours.
For this example, set the **Send Every ** interval for each sensor to every 30 seconds.
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](https://learn.adafruit.com/all-the-internet-of-things-episode-four-adafruit-io/advanced-feeds).
The LC709203F has two measurements that each have their own feeds. In this picture, we're looking at the battery cell percent reading, but if you click on the graph icon for the other measurement you'll see its feed history.
# No-Code Battery Monitoring with WipperSnapper
## Battery Level SMS Alert with Adafruit IO Actions
Danger: Adafruit IO PLUS ONLY: Adafruit IO's SMS Action requires your Adafruit IO account to have an active subscription to Adafruit IO PLUS. Adafruit IO PLUS ("IO+") is the PAID Adafruit IO plan. Visit https://io.adafruit.com/plus for more info.
First head over to your [Adafruit account page](https://accounts.adafruit.com/settings/validate_phone). Enter your phone number in the box and click **continue and verify**.
You should now receive a verification code at the mobile number you entered. Enter this code into the box labeled **verification code**. Press **submit**.
You should see a blue box that says **Successfully validated phone number** and your phone number in the box under **mobile number**.
If this is all correct you can continue to the next part of the guide.
From any page in Adafruit IO, click the link labelled **Actions**.
The Actions page shows a list of your Actions, with enable and info options for each Action, and a helpful search box for when you have a few in the list. Click the **New Action** button.
Now enter the **Name** and **Description** for your new action. You can change this later using the **Settings** button while editing an Action.
Now, using the **Triggers ** section of the toolbox/sidebar, grab the trigger that uses the phrase `gets data that Starts matching` and place it into the `Triggers:` section of the diagram.
By using that trigger, you can avoid the action from firing until only the newest data received matches the condition. It checks that the previous datapoint does not match first, as well as that the newest point does now match the condition.
Inside the trigger block just placed, change the **Feed** dropdown to point at the `Battery Percentage` feed.
Finally change the value block to be `95`, and the operator from equals (`=`) to **Greater than or equal to** (`≥`).
Make sure your action looks like the image below before continuing!
For the `Actions:` section of the diagram you'll want to use the **Send SMS** block from the **Notifications** toolbox category. Drag and drop it into place like before, and then update the message body text to mention the battery being fully charged.
Before continuing, make sure that your Action looks like the image below:
Finally choose **Save Changes** , and if asked then choose the **Enable and Save** option.
When the battery is fully charged, you should receive a text message from Adafruit IO!
Info: To include the time that the action was triggered in a message, you'll need to use the `feeds` template placeholder variable. Only feeds used in the `Actions:` section can be accessed via the `feeds` placeholder object, including their `last_value` and `created_at`. Try using a Log utility block to view the output of placeholders inside template blocks, especially `{{ vars }}` and `{{ feeds }}`.
This will be improved very soon, but it's nice to know that the power is there even if hidden away...
## Featured Products
### Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM
[Adafruit ESP32 Feather V2 - 8MB Flash + 2 MB PSRAM](https://www.adafruit.com/product/5400)
One of our star Feathers is the [Adafruit HUZZAH32 ESP32 Feather](https://www.adafruit.com/product/3405) - with the fabulous ESP32 WROOM module on there, it makes quick work of WiFi and Bluetooth® projects that take advantage of Espressifs most popular chipset. Recently we had...
In Stock
[Buy Now](https://www.adafruit.com/product/5400)
[Related Guides to the Product](https://learn.adafruit.com/products/5400/guides)
### Adafruit LC709203F LiPoly / LiIon Fuel Gauge and Battery Monitor
[Adafruit LC709203F LiPoly / LiIon Fuel Gauge and Battery Monitor](https://www.adafruit.com/product/4712)
Low cost Lithium Polymer batteries have revolutionized electronics - they're thin, they're light, they can be regulated down to 3.3V and they're easy to charge. On your phone, there's a little image of a battery cell that tells you the percentage of charge - so you know when...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4712)
[Related Guides to the Product](https://learn.adafruit.com/products/4712/guides)
### Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh
[Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh](https://www.adafruit.com/product/3898)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of **400mAh** for a total of about 1.9 Wh. If you need a larger (or smaller!)...
Out of Stock
[Buy Now](https://www.adafruit.com/product/3898)
[Related Guides to the Product](https://learn.adafruit.com/products/3898/guides)
### STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long
[STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long](https://www.adafruit.com/product/4210)
This 4-wire cable is a little over 100mm / 4" long and fitted with JST-SH female 4-pin connectors on both ends. Compared with the chunkier JST-PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove.
Out of Stock
[Buy Now](https://www.adafruit.com/product/4210)
[Related Guides to the Product](https://learn.adafruit.com/products/4210/guides)
### Pink and Purple Woven USB A to USB C Cable - 1 meter long
[Pink and Purple Woven USB A to USB C Cable - 1 meter long](https://www.adafruit.com/product/5153)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers, and more. [If you want something just like it but for Micro B, we...](https://www.adafruit.com/product/4111)
Out of Stock
[Buy Now](https://www.adafruit.com/product/5153)
[Related Guides to the Product](https://learn.adafruit.com/products/5153/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)
## Related Guides
- [Adafruit LC709203F LiPoly / LiIon Fuel Gauge and Battery Monitor](https://learn.adafruit.com/adafruit-lc709203f-lipo-lipoly-battery-monitor.md)
- [Adafruit ESP32 Feather V2](https://learn.adafruit.com/adafruit-esp32-feather-v2.md)
- [Garden Path Lights with WLED and a Sunset Timer](https://learn.adafruit.com/garden-path-lights-with-sunset-timer.md)
- [itsaSNAP Apple Health Status Board](https://learn.adafruit.com/itssnap-apple-fitness-status-board.md)
- [Holiday Lights: Easy DIY Christmas Wreath & Garland with WLED](https://learn.adafruit.com/holiday-garland-decor-app-control-with-no-coding.md)
- [Introducing Adafruit Feather](https://learn.adafruit.com/adafruit-feather.md)
- [Sound Reactive Paper Lanterns with LedFx](https://learn.adafruit.com/sound-reactive-paper-lanterns-with-led-fx.md)
- [Adafruit IO Basics: Analog Output](https://learn.adafruit.com/adafruit-io-basics-analog-output.md)
- [Adafruit IO Basics: Digital Output](https://learn.adafruit.com/adafruit-io-basics-digital-output.md)
- [WiFi Jellyfish Lantern with WLED](https://learn.adafruit.com/wifi-jellyfish-lantern-with-wled.md)
- [Pico W PiCowBell Case](https://learn.adafruit.com/pico-w-picowbell-case.md)
- [CircuitPython on ESP32 Quick Start](https://learn.adafruit.com/circuitpython-with-esp32-quick-start.md)
- [No-Code Pool Party Notifier](https://learn.adafruit.com/pool-party-notification-device.md)
- [How to Add a New Board to WipperSnapper](https://learn.adafruit.com/how-to-add-a-new-board-to-wippersnapper.md)
- [Adafruit IO Basics: Color](https://learn.adafruit.com/adafruit-io-basics-color.md)
- [Using ItsaSNAP for HomeKit PIR Motion Detection](https://learn.adafruit.com/itsasnap-homekit-pir-motion-detection.md)