John's ESPHome Components and Devices

Welcome to my ESPhome configuration directory. This repository contains the ESPhome devices I use in my home as well as external components I've developed.

Components

Component	Description
TFmini	External component for the TFmini-S time of flight distance sensor with distance, signal strength, and temperature readings
Adxl345	External component for the ADXL345 accelerometer. Measures acceleration along x, y and z axes.

Devices

• Garage Door Controller
• Bed Controller

Garage Door Controller

Features

• TFmini-S Sensor code to measure vehicle's distance from front of garage.
• LED Strip to display green for pulling vehicle into garage, yellow to slow down, and red to stop.
• Sensor to read door open/close status.
• Relay to push garage door controller button to open/close garage door.
• 30 second timeout turns off LED lights after vehicle leaves or is parked.

Try it yourself!

Try the interactive simulator

Files

File	Description
garage-door-controller.yaml	ESPHome Code for garage door controller
components/tfmini	TFmini-S external component (replaces the old TFmini.h custom component)

Parts List

Links go to Amazon.com.

• ESP32 Mini
• TFmini-S - measures distance to vehicle
• WS2812B LED Strip - only 1 meter needed
• SRD-05VDC-SL-C - 5V relay module to "push" door control button
• CYT1070 - Level shifter to convert ESP's 3.3V to LED Strip 5.0V
• 5V 2A Micro USB Power adapter to power ESP and LED Strip.
• Magnetic door sensor - there are hundreds of variants on Amazon, take your pick as long as it is normally open when the magnets are apart.

Hook Up

1. (Optional) Solder pin headers to ESP32 Mini. You will only need the inner most set of pins. You can also solder connections directly to the ESP32 mini if desired. I like to mount my parts on a Solderable breadboard, so pin headers are needed.
2. The TFminiS is connected to GPIO21 for RXD and GPIO22 for TXD. The YAML file configures a UART where TXD on the ESP32 connects to RXD on the TFmini and ditto for RXD to TXD. The TFminiS is powered via 5V.
3. The data line on the LED strip is connected to GPIO16 through the level shifter LV (low voltage) pin. The YAML file configures an addressable light component on this pin.
4. Connect the 5V relay to the ESP32 GPIO17. The other normally open (NO) end of the relay connects to your door opener's push button. The YAML file configures the GPIO17 to trigger with a 500ms pulse.
5. Connect one wire from the door sensor to ground and the other wire to GPIO23 on the ESP32.

Software Install

You can copy/paste the YAML code to your ESPHome device's file. You'll need to skip over the "ap", "ota", and "wifi" sections to maintain your own secrets. Or, alternatively, place the secrets and passwords into your own secrets.yaml file.

Add the TFmini-S external component to your configuration:

external_components:
  - source: github://jdillenburg/esphome@master
    components: [ tfmini ]

See the TFmini component documentation for more details on configuration options.

Bed Controller

Features

• Controls the inclination of an adjustable bed using a motor controller
• ADXL345 accelerometer to measure and track bed angle
• LCD display showing current and desired position
• Status LED for visual feedback
• Home Assistant integration with controls for:
  • Setting desired position percentage
  • Setting upper and lower angle limits
  • Adjusting accuracy tolerance
  • Controlling motor speed

Files

File	Description
bed-controller2.yaml	ESPHome code for bed angle controller
components/adxl345	ADXL345 external component for measuring bed angle

Parts List

• ESP32-C3-DevKitM-1 board
• ADXL345 accelerometer - mounted under the bed frame
• 12V motor with motor controller (requires PWM inputs)
• LCD display with PCF8574 I2C adapter (16x2)
• WS2812 RGB LED for status indication

Hook Up

1. Connect GPIO4 and GPIO5 to the motor controller's forward and reverse PWM inputs
2. Connect GPIO6 and GPIO7 to the motor controller's enable pins
3. Connect the ADXL345 accelerometer via I2C (SDA to GPIO0, SCL to GPIO1)
4. Connect the LCD display via I2C (address 0x27, same I2C bus as the accelerometer)
5. Connect assumes RGB LED connected to GPIO8 for status indication. My ESP32 had this built-in.

Software Install

Add the ADXL345 external component to your configuration:

external_components:
  - source:
      type: git
      url: https://github.com/jdillenburg/esphome
      ref: main
    components: [ adxl345 ]

See the ADXL345 component documentation for more details on configuration options.