This is a collection of ESPHome custom components, configuration files, and custom code for my various ESP8266/ESP32 devices that integrate with Home Assistant. I am using includes and packages pretty extensively in order to prevent duplication and allow for easy changing of common settings.
ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configuration files and control them remotely through Home Automation systems. For more information checkout ESPHome.io.
Home Assistant is open source home automation that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Perfect to run on a Raspberry Pi or a local server. For more information check out Home-Assistant.io.
/- Yaml files for my devices and other core files/components- Custom components/docs- Detailed write-ups (photos, schematics, notes) for my more complex/custom devices/images- Misc pictures not tied to a specific device doc/packages- Shared packages used by my devices/scripts- Scripts for managing the repo
You will notice that throughout the various folders I have secrets.yaml files. These files all do an include of the secrets.yaml file in the root folder (that for obvious reasons is not included in the repo).
I have been working on updating most of my custom code into components that can easily be pulled directly from GitHub into your device configuration using the external components component. I have run into frequent issues with changes in ESPHome breaking my components so I am now tagging my repo with the version of ESPHome it is compatible with. I generally upgrade pretty quickly so as soon as I have confirmed things are working and/or made the neccessary changes I will add a tag for the new version of ESPHome. While I primarily design these components for my own personal use cases I hope that at least some of them are useful for others. If you are using one of my components and have an enhancement/feature you would like to see feel free to add an issue and I will see what I can do to get it added.
Schedule-based control for a pool's primary circulation pump, an auxiliary cleaner pump, and an optional heater, with current-sensed anomaly detection. Runs on the ESP32-S3 in my Pool controller. Details: components/pool_controller/README.md.
A light component for TREO LED Pool Lights that exposes each color as a selectable "effect" in Home Assistant. Details: components/treo_led_pool_light/README.md.
A native ESPHome component for the PZEM-6L24 three-phase AC energy meter (voltage/current/power/energy per phase over Modbus RTU). Used by my Pool controller to monitor the pump and cleaner. Details: components/pzem6l24/README.md.
Detects per-side bed occupancy using resistive pressure sensors multiplexed onto a single ADC input. Used by Master Bed. Details: components/bed_sensor/README.md.
A single Home Assistant climate entity that manages a multi-zone Econet-connected furnace/AC, balancing airflow across zones when idle and syncing mode/temperature with the physical thermostat. Used by HVAC. Details: components/econet_zone_control/README.md.
Sits in front of an Econet water heater so any target temperature can be set from Home Assistant while the physical unit itself stays pinned at a fixed setting (150°F) — the physical control panel only lets you adjust it to values above 140°F, so this is how I get finer/lower control (useful for time-of-use electric rates). Used by Water Heater. Details: components/high_temp_water_heater/README.md.
This is a NodeMCU that I installed in my Cuisinart Coffee Maker. It has GPIO's connected to the indicator lights for the bold setting and power and has a couple of relays connected to the bold setting button and the power button.
This is a WEMOS D1 Mini Pro that is connected to a couple of relays and a couple of water proof push buttons red and blue. The multi-click config on the fire pit switch is so that any press will turn it off but to turn it on you have to press it for 3 seconds (to try and prevent kids from turning it on). This is used to control the combination fire pit and fountain in my backyard. I just got this hooked up and is working good other then the fire pit doesn't always come on on the first try (I think I am getting some bounce in the switch but haven't had a chance to troubleshoot further).
A M5Stack ATOM HUB SwitchD with power and temperature monitoring plus PID-controlled freeze-protection heaters. Full write-up and photos: docs/garage-fridge.
A M5Stack ATOMIC RS485 Base with an ESP32 connected to a 3-zone Rheem furnace/AC system (Main Floor, Upstairs, Basement) integrated via ESPHome Econet and the custom Econet Zone Control component, which presents all zones as a single Home Assistant climate entity and balances airflow across zones when idle. Full write-up: docs/hvac.
A NodeMCU under the mattress that detects per-side occupancy using a pair of Force Sensitive Resistors and the custom bed_sensor component. Full write-up: docs/master-bed.
A Waveshare ESP32-S3 7" Touch LCD B running the custom Pool Controller and PZEM-6L24 components to manage pump scheduling, water chemistry, and (eventually) heat/fill/drain. Full write-up: docs/pool.
A M5Stack ATOMIC RS485 Base with an ESP32 connected to a Rheem hybrid water heater managed through the ESPHome Econet component. The custom High Temp Water Heater component sits in front of it so I can set any target temperature I want (e.g. 140°F during peak electric rate hours) while the physical water heater setting itself stays fixed at 150°F — the physical control panel only lets you adjust it to values above 140°F.
This device is sinificantly cheaper then a Sense Energy Monitor, can monitor 16 circuits in addition to the mains (Sense can only do 2 additional), and comes with all of the additional CT clamps. Like the Sense it is intended to work with a cloud service but because it is based on an ESP32 it can be flashed with ESPHome and made a local only device. More details can be found here.
I have a bunch of these smart plugs that I use for various things where I want to monitor the power consumption and/or be able to completely turn off the power (because they have a significant standby power draw). The TOPGREENER units are cheap, can be flashed with Tuya-Convert (or they could last time I bought one), and have power monitoring.
- Basement Fridge
- Basement TV
- Family Room TV
- Kitchen Fridge
- Network Equipment
- Sump Pump
- Washing Machine
My basement bathroom has a single gang box (and not enough room to swith to dual gang) for the switches to control the shower light and heat lamps so this is a perfect fit. The price is right, the buttons feel solid, and I was able to flash it using Tuya-Convert. It does seem to have corners that are squarer then typical so I had a little bit of trouble getting a standard cover to fit but nothing I couldn't fix with a file.
This is installed in place of the switch that controled my TREO LED Pool Lights. These lights have the option to select different colors by briefly turning them off and back on again and they do remember the last color when turned on again. The custom Treo Led Pool Lights component handles tracking the current color and exposes custom "effects" for each of the colors to Home Assistant. I have this configured to turn the lights on/off with the top/bottum buttons and use the middle button to change colors.
My garage lights are not dimmable so I decided to try out a Shelly device, I have this connected to a Leviton 5657-2W Momentary Center-Off Decora Rocker. Overall I am fairly happy with it I just wish the rocker switch wasn't so expensive or there was another similar option.
Both garage door openers are controlled by ratgdo boards running the esphome-ratgdo external package, which taps into the opener's built-in security+2.0 wall panel/dry-contact wiring instead of a relay-across-the-button hack.
- Main Garage Door — v2.5i board variant connected to a Chambelain MyQ opener
- Second Garage Door — dry-contact variant connected to an old opener
An ESP32 running ESPHome's Bluetooth Proxy to extend Home Assistant's Bluetooth range.