dlitz/jdillenburg-esphome
1
0
Fork 0
mirror of https://github.com/jdillenburg/esphome.git synced 2026-01-10 07:10:39 -07:00
Code Issues Packages Projects Releases Wiki Activity

Updated main doc to point at tfmini-s

Browse Source
This commit is contained in:
John Dillenburg
2025-03-01 15:22:53 -06:00
parent 1a7851a0f7
commit d0db0b074d
1 changed files with 29 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
README.md
View File

@@ -1,13 +1,21 @@
# John's ESPHome Devices
Welcome to my ESPhome configuration directory. This repository contains the ESPhome devices I use in my home:
# 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.
* [Garage Door Controller](http://...#garage-door-controller)
## Components
| Component | Description |
|-----------|-------------|
| [TFmini](components/tfmini) | External component for the TFmini-S time of flight distance sensor with distance, signal strength, and temperature readings |
## Devices
* [Garage Door Controller](#garage-door-controller)
## <a name="garage-door-controller">Garage Door Controller</a>
![Garage Door Controller Home Assistant Dashboard](README_Assets/garage-door-controller-dashboard-example_small.png "Garage Door Controller Home Assistant Dashboard")
### Features
* TFmini-S Sensor code to measure vehcile's distance from front of garage.
* 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.
@@ -20,7 +28,7 @@ Welcome to my ESPhome configuration directory. This repository contains the ESP
| File | Description |
|-------------------------------|--------------------------------|
| [garage-door-controller.yaml](https://github.com/jdillenburg/esphome/blob/main/garage-door-controller.yaml) | ESPHome Code for garage door controller |
| [TFmini.h](https://github.com/jdillenburg/esphome/blob/main/TFmini.h) | Reads TFmini-S distance to car as a custom component |
| [components/tfmini](components/tfmini) | TFmini-S external component (replaces the old TFmini.h custom component) |
### Parts List
Links go to Amazon.com.
@@ -30,7 +38,7 @@ Links go to Amazon.com.
* [SRD-05VDC-SL-C](https://www.amazon.com/gp/product/B09G6H7JDT/ref=ppx_yo_dt_b_search_asin_title?ie=UTF8&psc=1) - 5V relay module to "push" door control button
* [CYT1070](https://www.amazon.com/gp/product/B073D4DJDC/ref=ppx_yo_dt_b_search_asin_title?ie=UTF8&psc=1) - 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](https://www.amazon.com/WESUA-Magnetic-Overhead-Contacts-Bracket/dp/B0BCYHBKVF?crid=3JFEWKWK89V1B&dib=eyJ2IjoiMSJ9.uJDdgjdeS3uEOsVaAps0i112QeIcTdBiISTaTjU41myRba5tAMceEsQTFUEHSmu07uQLz9wCZ7WUNuGEg1LKry18cc2nbD9lIAvBB-k77UImIj0fIZQKsXObVGPR76Z0j6lm5VDni9AUo5934nR9TjJOSm2XWZaltlVvvHNQMwmxcW8XvHVSbU4ZyTTBrzY98hJOFs0y425okmUaoITHpAzkdb2TDlGVS7U9sem-KoN--boaKqIfsh_DEr1JIsZNMtRlvHjhRkolxgLjXQ3vEAetyLac6D_zc9el6BPJbw4.D-wK21SM9Cq3gHdmdCxJqH47AkVhG9anOlfFXXv_axQ&dib_tag=se&keywords=5V+magnetic+garage+door+sensor&qid=1732491358&sprefix=5v+magnetic+garage+door+sensor%2Caps%2C141&sr=8-3) - there are hundreds of variants on Amazon, take your pick as long as it is normally open when the magnets are apart.
* [Magnetic door sensor](https://www.amazon.com/WESUA-Magnetic-Overhead-Contacts-Bracket/dp/B0BCYHBKVF) - there are hundreds of variants on Amazon, take your pick as long as it is normally open when the magnets are apart.
### Hook Up
@@ -44,4 +52,12 @@ Links go to Amazon.com.
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.
You will also need to upload the TFmini.h file to your Home Assistant config/esphome directory in order for the compilation to succeed.
Add the TFmini-S external component to your configuration:
```yaml
external_components:
- source: github://jdillenburg/esphome@master
components: [ tfmini ]
```
See the [TFmini component documentation](components/tfmini) for more details on configuration options.