# USB C Power Delivery Monitor
## Overview
USB C Power Delivery is terrific -- your compatible devices can request the proper voltage from a PD power supply. But you know what's even cooler? Telling your supply exactly which voltage you want so you can drive all sorts of DC powered gizmos without searching around for wall warts!
This project shows you how to build an interface to communicate with your PD supply as well as display the current usage of your devices. It uses an ESP32-S2 Reverse TFT Feather running CircuitPython plus two I2C breakouts -- the INA291 and HUSB238 for current measurement and voltage selection (such as 5V, 9V, 12V, 15V, & 20V).
This is a plug-and-play project -- no soldering required! Build it on a swirly grid and encase it in an optional 3D printed enclosure.
https://www.youtube.com/live/__pFePd8Jbg?feature=shared&t=1831
## Parts
### Adafruit ESP32-S2 Reverse TFT Feather
[Adafruit ESP32-S2 Reverse TFT Feather](https://www.adafruit.com/product/5345)
Like Missy Elliot, we like to ["put our [Feather] down, flip it and reverse it"](https://www.youtube.com/watch?v=cjIvu7e6Wq8) and that's exactly what we've done with this new development board. It's basically our ****
In Stock
[Buy Now](https://www.adafruit.com/product/5345)
[Related Guides to the Product](https://learn.adafruit.com/products/5345/guides)
### Adafruit USB Type C Power Delivery Dummy - I2C or Switchable
[Adafruit USB Type C Power Delivery Dummy - I2C or Switchable](https://www.adafruit.com/product/5991)
The HUSB238 USB PD sink chip is neat in that you can either use switches (really, resistor selection) to set the desired PD voltage _or_ use I2C for dynamic querying and setting. We already stock a simple ****
Out of Stock
[Buy Now](https://www.adafruit.com/product/5991)
[Related Guides to the Product](https://learn.adafruit.com/products/5991/guides)
### INA219 High Side DC Current Sensor Breakout - 26V ±3.2A Max
[INA219 High Side DC Current Sensor Breakout - 26V ±3.2A Max](https://www.adafruit.com/product/904)
This breakout board will solve all your power-monitoring problems. Instead of struggling with two multimeters, you can just use the handy INA219 chip on this breakout to both measure both the high side voltage and DC current draw over I2C with ±1% precision.
**Please...**
Out of Stock
[Buy Now](https://www.adafruit.com/product/904)
[Related Guides to the Product](https://learn.adafruit.com/products/904/guides)
### Adafruit Swirly Aluminum Mounting Grid for 0.1" Spaced PCBs
[Adafruit Swirly Aluminum Mounting Grid for 0.1" Spaced PCBs](https://www.adafruit.com/product/5780)
With most of our dev boards, sensors and feathers now sporting [plug-and-play stemma QT ports](https://learn.adafruit.com/search?q=stemma%2520qt) it can be very fast to put together projects with half a dozen boards snapped together. But that ease of use has one...
In Stock
[Buy Now](https://www.adafruit.com/product/5780)
[Related Guides to the Product](https://learn.adafruit.com/products/5780/guides)
### Waterproof DC Power Cable Set - 5.5/2.1mm
[Waterproof DC Power Cable Set - 5.5/2.1mm](https://www.adafruit.com/product/743)
Outdoor enthusiasts rejoice! We now have standard 5.5/2.1mm DC power cable sets in a waterproof variety. These cable sets are ideal for projects that must weather the weather: dust, water, rain, snow, tornado (not volcano proof!). They are a little bulkier than normal DC jacks because of the...
In Stock
[Buy Now](https://www.adafruit.com/product/743)
[Related Guides to the Product](https://learn.adafruit.com/products/743/guides)
### Black Nylon Machine Screw and Stand-off Set – M2.5 Thread
[Black Nylon Machine Screw and Stand-off Set – M2.5 Thread](https://www.adafruit.com/product/3299)
Totaling 380 pieces, this **M2.5 Screw Set** is a must-have for your workstation. You'll have enough screws, nuts, and hex standoffs to fuel your maker tendencies for days on end! M2.5 size screws fit almost all of the Adafruit breakout/dev board mounting holes...
In Stock
[Buy Now](https://www.adafruit.com/product/3299)
[Related Guides to the Product](https://learn.adafruit.com/products/3299/guides)
### USB C to USB C Cable - USB 3.1 Gen 4 with E-Mark - 1 meter long
[USB C to USB C Cable - USB 3.1 Gen 4 with E-Mark - 1 meter long](https://www.adafruit.com/product/4199)
As technology changes and adapts, so does Adafruit! Rather than the regular USB A, this cable has **USB C to USB C** plugs!
USB C is the latest industry-standard connector for transmitting data _and_ power. Like Lightning and MagSafe cables, USB C...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4199)
[Related Guides to the Product](https://learn.adafruit.com/products/4199/guides)
### In-line power switch for 2.1mm barrel jack
[In-line power switch for 2.1mm barrel jack](https://www.adafruit.com/product/1125)
Add a power switch to _any_ project simply by plugging this between the power supply. This is the most useful thing you never knew you needed! You'll want to pick up a bunch for your electronic projects.
Comes with a 5.5/2.1mm barrel jack on one end an a plug on the...
In Stock
[Buy Now](https://www.adafruit.com/product/1125)
[Related Guides to the Product](https://learn.adafruit.com/products/1125/guides)
### Part: STEMMA QT / Qwiic JST SH 4-Pin Cable
quantity: 2
50mm Long
[STEMMA QT / Qwiic JST SH 4-Pin Cable](https://www.adafruit.com/product/4399)
### Multi-port USB Power Delivery Supply
Such as [this one from Anker.](https://www.amazon.com/gp/product/B0C4DGBHY2)
# USB C Power Delivery Monitor
## Build the Power Deliverer
## Swirly Grid
Connect one STEMMA QT cable to the Feather before fastening it to the swirly grid, since the port will be hard to access afterwards.
Fasten the Feather to the grid as shown using M2.5 x 12mm F-F hex standoffs and short screws.
Mount the breakout boards with M2.5 x 6mm F-F standoffs as shown.
## Connections
The Power Deliverer is assembled without any soldering. Plugging in STEMMA QT cables and screwing in wires to terminal blocks is all that's required.
Follow the Fritzing diagram above to see how it all goes together.
First, plug a STEMMA QT cable from the Feather to the INA219 board.
A second STEMMA QT cable connects the INA219 to the HUSB238 Power Delivery Dummy.
To measure current, the INA219 is connected between the HUSB238 and the DC powered device you're running:
- **HUSB238 V+ to INA219 V-**
- **INA219 V+ to DC output V+**
- **HUSB238 GND to DC output GND**
The output DC power socket is the female half of the waterproof DC power cable set which can either run out of the case freely or be zip-tied to the swirly grid as shown.
## 3D Printed Case
You can optionally 3D print a case to cover the Power Deliverer.
The case was designed so the 10x2 swirly grid snap fits into the base. There are cutouts for the two USB C ports, the DC power line, and the TFT display.
Four push tabs can be used to press the Feather's buttons.
Download the STL model linked below to print on an FDM printer. You can use the STEP file as a launching off point for modifications and remixes.
[Power Deliverer case models -- STL & STEP](https://cdn-learn.adafruit.com/assets/assets/000/132/036/original/power_deliverer_case_model.zip?1725423645)
### Snap Into Place
Feed the Power Deliverer into the case as shown, making sure to line up the ports with the holes.
# USB C Power Delivery Monitor
## CircuitPython
[CircuitPython](https://github.com/adafruit/circuitpython) is a derivative of [MicroPython](https://micropython.org) designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. Simply copy and edit files on the **CIRCUITPY** drive to iterate.
## CircuitPython Quickstart
Follow this step-by-step to quickly get CircuitPython running on your board.
[Download the latest version of CircuitPython for this board via circuitpython.org](https://circuitpython.org/board/adafruit_feather_esp32s2_reverse_tft/)
**Click the link above to download the latest CircuitPython UF2 file.**
Save it wherever is convenient for you.
Plug your board into your computer, using a known-good data-sync cable, directly, or via an adapter if needed.
Double-click the **reset** button (highlighted in red above), and you will see the **RGB status LED(s)** turn green (highlighted in green above). If you see red, try another port, or if you're using an adapter or hub, try without the hub, or different adapter or hub.
For this board, tap reset and wait for the LED to turn purple, and as soon as it turns purple, tap reset again. The second tap needs to happen while the LED is still purple.
If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the rhythm right!
A lot of people end up using charge-only USB cables and it is very frustrating! **Make sure you have a USB cable you know is good for data sync.**
You will see a new disk drive appear called **FTHRS2BOOT**.
Drag the **adafruit\_circuitpython\_etc.uf2** file to **FTHRS2BOOT**.
The **BOOT** drive will disappear and a new disk drive called **CIRCUITPY** will appear.
That's it!
# USB C Power Delivery Monitor
## Code the Power Deliverer
## Text Editor
Adafruit recommends using the **Mu** editor for editing your CircuitPython code. You can get more info in [this guide](https://learn.adafruit.com/welcome-to-circuitpython/installing-mu-editor).
Alternatively, you can use any text editor that saves simple text files.
## Download the Project Bundle
Your project will use a specific set of CircuitPython libraries and the **code.py** file. To get everything you need, click on the **Download Project Bundle** link below, and uncompress the .zip file.
Drag the contents of the uncompressed bundle directory onto your board's **CIRCUITPY** drive, replacing any existing files or directories with the same names, and adding any new ones that are necessary.
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/USB_C_Power_Deliverer/code.py
## How it Works
#### **Library Imports**
First, we import all the necessary libraries -- these allow us to interact with the current sensor and the Power Delivery dummy, as well as display text and shapes on the TFT screen.
```auto
import time
import board
import keypad
import displayio
import terminalio
from adafruit_display_text import label
from adafruit_display_shapes.rect import Rect
import adafruit_husb238
from adafruit_ina219 import INA219
```
#### **Setup I2C and Keypad**
Initialize I2C bus and set up buttons for input.
```auto
i2c = board.I2C()
tft_d0_button = keypad.Keys((board.D0,), value_when_pressed=False, pull=True)
tft_buttons = keypad.Keys((board.D1, board.D2), value_when_pressed=True, pull=True)
```
#### **Initialize INA219 Sensor**
Create an instance of the INA219 sensor to measure current.
```auto
ina219 = INA219(i2c)
```
#### **Display Configuration**
Next, we set up the display, color variables, and the background.
```auto
TXTCOL_VOLT = 0x8f00cd
TXTCOL_CURR = 0xb30090
TXTCOL_DIM = 0xCD8F00
TXTCOL_HEAD = 0xCD8F00
TXTCOL_BTN = 0xa0a0a0
BGCOL = 0x220030
display = board.DISPLAY
group = displayio.Group()
background_rect = Rect(0, 0, display.width, display.height, fill=BGCOL)
group.append(background_rect)
```
#### **Initialize HUSB238**
Here, we set up the USB-C PD controller dummy so we can ask the PD supply for different voltages. If the USB-C PD supply is unplugged, it displays a warning message rather than crash the code.
```auto
try:
pd = adafruit_husb238.Adafruit_HUSB238(i2c)
RUNNING = True
PLUGGED = True
except ValueError:
print("plug in a USB C PD cable, then press reset")
RUNNING = False
PLUGGED = False
warning_label = label.Label(
FONT, text=warning_text, color=0xdd0000,
scale=1, anchor_point=(0,0),
anchored_position=(20, 10)
)
group.append(warning_label)
#stop the code here
```
#### **Main Loop**
In the main loop, the available voltages are displayed and button presses handled -- these change the voltage settings and update the display with current readings.
```auto
while True:
tft_d0_button_event = tft_d0_button.events.get()
if tft_d0_button_event and tft_d0_button_event.pressed:
try:
print(f"Setting to {voltages[v]}V!")
pd.voltage = voltages[v]
voltage_label.text=str(voltages[v]) + "V"
voltage_label.color=TXTCOL_VOLT
print(f"It is set to {pd.voltage}V/{pd.current}A")
PLUGGED=True
except OSError:
print(warning_text)
voltage_label.text="replug"
current_label.text="USB C"
PLUGGED=False
if PLUGGED:
tft_buttons_event = tft_buttons.events.get()
if tft_buttons_event and tft_buttons_event.pressed:
if tft_buttons_event.key_number == 0:
v = (v + 1) % len(voltages)
voltage_label.color=TXTCOL_DIM
voltage_label.text="["+str(voltages[v]) + "V]"
print(f"Voltage will be set to {voltages[v]}V")
if tft_buttons_event.key_number == 1:
v = (v - 1) % len(voltages)
voltage_label.color=TXTCOL_DIM
voltage_label.text="["+str(voltages[v]) + "V]"
print(f"Voltage will be set to {voltages[v]}V")
current = ina219.current
current_label.text= str(abs(int(current))) + "mA"
if ina219.overflow:
print("Internal Math Overflow Detected!")
time.sleep(0.2)
```
# USB C Power Delivery Monitor
## Use the Power Deliverer
https://www.youtube.com/live/__pFePd8Jbg?feature=shared&t=1831
To use the Power Deliverer you'll plug in your PD supply USB C cable to the HUSB238 (the white cable in these photos).
Plug in the second USB C cable to the Feather.
Plug in a DC barrel plug for the powered device -- the fan in these photos.
Select a higher or lower voltage with the two lower buttons ( **+/-** ) on the left side of the device. To **set** that voltage, press the top button.
The current draw is displayed in the lower section of the screen.
Should the USB PD supply become unplugged the screen will let you know to re-insert the plug.
## Featured Products
### Adafruit ESP32-S2 Reverse TFT Feather
[Adafruit ESP32-S2 Reverse TFT Feather](https://www.adafruit.com/product/5345)
Like Missy Elliot, we like to ["put our [Feather] down, flip it and reverse it"](https://www.youtube.com/watch?v=cjIvu7e6Wq8) and that's exactly what we've done with this new development board. It's basically our ****
In Stock
[Buy Now](https://www.adafruit.com/product/5345)
[Related Guides to the Product](https://learn.adafruit.com/products/5345/guides)
### Adafruit USB Type C Power Delivery Dummy - I2C or Switchable
[Adafruit USB Type C Power Delivery Dummy - I2C or Switchable](https://www.adafruit.com/product/5991)
The HUSB238 USB PD sink chip is neat in that you can either use switches (really, resistor selection) to set the desired PD voltage _or_ use I2C for dynamic querying and setting. We already stock a simple ****
Out of Stock
[Buy Now](https://www.adafruit.com/product/5991)
[Related Guides to the Product](https://learn.adafruit.com/products/5991/guides)
### INA219 High Side DC Current Sensor Breakout - 26V ±3.2A Max
[INA219 High Side DC Current Sensor Breakout - 26V ±3.2A Max](https://www.adafruit.com/product/904)
This breakout board will solve all your power-monitoring problems. Instead of struggling with two multimeters, you can just use the handy INA219 chip on this breakout to both measure both the high side voltage and DC current draw over I2C with ±1% precision.
**Please...**
Out of Stock
[Buy Now](https://www.adafruit.com/product/904)
[Related Guides to the Product](https://learn.adafruit.com/products/904/guides)
### Adafruit Swirly Aluminum Mounting Grid for 0.1" Spaced PCBs
[Adafruit Swirly Aluminum Mounting Grid for 0.1" Spaced PCBs](https://www.adafruit.com/product/5780)
With most of our dev boards, sensors and feathers now sporting [plug-and-play stemma QT ports](https://learn.adafruit.com/search?q=stemma%2520qt) it can be very fast to put together projects with half a dozen boards snapped together. But that ease of use has one...
In Stock
[Buy Now](https://www.adafruit.com/product/5780)
[Related Guides to the Product](https://learn.adafruit.com/products/5780/guides)
### Black Nylon Machine Screw and Stand-off Set – M2.5 Thread
[Black Nylon Machine Screw and Stand-off Set – M2.5 Thread](https://www.adafruit.com/product/3299)
Totaling 380 pieces, this **M2.5 Screw Set** is a must-have for your workstation. You'll have enough screws, nuts, and hex standoffs to fuel your maker tendencies for days on end! M2.5 size screws fit almost all of the Adafruit breakout/dev board mounting holes...
In Stock
[Buy Now](https://www.adafruit.com/product/3299)
[Related Guides to the Product](https://learn.adafruit.com/products/3299/guides)
### 30 Piece 5.5 / 2.1mm to DC Barrel Jack Adapter Kit
[30 Piece 5.5 / 2.1mm to DC Barrel Jack Adapter Kit](https://www.adafruit.com/product/5474)
We have a lot of [power adapter packs](https://www.adafruit.com/category/137) in the shop - from [9V](https://www.adafruit.com/product/63) to [12V](https://www.adafruit.com/product/352) to [5V](https://www.adafruit.com/product/658) we even have...
In Stock
[Buy Now](https://www.adafruit.com/product/5474)
[Related Guides to the Product](https://learn.adafruit.com/products/5474/guides)
### Waterproof DC Power Cable Set - 5.5/2.1mm
[Waterproof DC Power Cable Set - 5.5/2.1mm](https://www.adafruit.com/product/743)
Outdoor enthusiasts rejoice! We now have standard 5.5/2.1mm DC power cable sets in a waterproof variety. These cable sets are ideal for projects that must weather the weather: dust, water, rain, snow, tornado (not volcano proof!). They are a little bulkier than normal DC jacks because of the...
In Stock
[Buy Now](https://www.adafruit.com/product/743)
[Related Guides to the Product](https://learn.adafruit.com/products/743/guides)
### 2.1mm female/male barrel jack extension cable
[2.1mm female/male barrel jack extension cable](https://www.adafruit.com/product/327)
This product is a 3-in-1 cable. By itself, it can act as an extension cord for any 5.5/2.1mm DC power cable. The heavy 24 AWG wires can handle up to 5A.
You can also cut it half to make two barrel cables (one plug and one jack). This will allow you to connect a classic 'wall...
In Stock
[Buy Now](https://www.adafruit.com/product/327)
[Related Guides to the Product](https://learn.adafruit.com/products/327/guides)
## Related Guides
- [Adafruit ESP32-S2 Reverse TFT Feather](https://learn.adafruit.com/esp32-s2-reverse-tft-feather.md)
- [Adafruit USB Type C Power Delivery Switchable Breakout](https://learn.adafruit.com/adafruit-usb-type-c-power-delivery-switchable-breakout.md)
- [Ninja Timer: Giant 7-Segment Display](https://learn.adafruit.com/ninja-timer-giant-7-segment-display.md)
- [ItsyBitsy ESP32 wFL case](https://learn.adafruit.com/itsybitsy-esp32-wfl-case.md)
- [Kitty Toe Bean Keypad with Color TFT](https://learn.adafruit.com/kitty-toe-bean-paw-keypad-color-tct.md)
- [Remote Control Candy Dispenser Ghost](https://learn.adafruit.com/ble-claw.md)
- [Compost Friend!](https://learn.adafruit.com/compost-optimization-machine.md)
- [Numpad 4000 Mechanical Keyswitch Data Entry Device](https://learn.adafruit.com/numpad-4000-mechanical-keyswitch-data-entry-device.md)
- [Programmable Wireless BLE Gesture Mouse](https://learn.adafruit.com/ble-wireless-gesture-mouse.md)
- [Ambient Video Lighting with HyperHDR](https://learn.adafruit.com/ambient-video-lighting-with-hyperhdr.md)
- [I2C Addresses and Troublesome Chips](https://learn.adafruit.com/i2c-addresses.md)
- [4x4 Rotary Encoder MIDI Messenger](https://learn.adafruit.com/4x4-rotary-encoder-midi-messenger.md)
- [USB Host to BLE Keyboard Adapter](https://learn.adafruit.com/esp32-s3-usb-to-ble-keyboard-adapter.md)
- [Pro Trinket Power Meter](https://learn.adafruit.com/pro-trinket-power-meter.md)
- [CircuitPython Elgato WiFi Light Controller](https://learn.adafruit.com/circuitpython-elgato-wifi-light-controller.md)
- [ESP32-S3 BLE RS-232 Controller](https://learn.adafruit.com/esp32-s3-ble-rs232-controller.md)
- [Ambient Sound Machine](https://learn.adafruit.com/ambient-machine.md)