Skip to content

Commit 8313cf8

Browse files
committed
add couple of photos and notes about first install
1 parent dc9b39f commit 8313cf8

File tree

4 files changed

+33
-1
lines changed

4 files changed

+33
-1
lines changed

README.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -112,9 +112,10 @@ Graph of the ESP-to-sensor connections:
112112
<img title="Sensors" alt="Sensors" src="images/ESP-to-sensors-connections.drawio.png">
113113

114114

115+
115116
## Full ESPHome configuration
116117

117-
See the [main.yaml](./main.yaml) file.
118+
See the [main.yaml](./main.yaml) file for the ESPHome package provided by this project.
118119
Please note that this is an [ESPHome package](https://esphome.io/components/packages/) and thus it uses [substitutions](https://esphome.io/components/substitutions/) to make the YAML config file as reusable as possible.
119120

120121
An actual ESPHome YAML config using this package could be:
@@ -144,6 +145,37 @@ Then it's overriding just the name & friendly name from the package.
144145
See e.g. [example-instance.yaml](./example-instance.yaml)
145146
and [example-instance-with-different-sensors.yaml](./example-instance-with-different-sensors.yaml).
146147

148+
149+
## First ESPHome install
150+
151+
When you receive your ESP32 relay board, you will need to carry out the first ESPHome installation
152+
by "wire". Afterwards, you'll be able to install any ESPHome profile over the wireless connection using
153+
the so-called On-The-Air update (OTA update).
154+
155+
Make sure you read carefully the [ESPHome guide](https://esphome.io/guides/physical_device_connection/)
156+
on how to Physically Connecting to your Device.
157+
158+
You will need a USB-to-serial module.
159+
I bought [one on Aliexpress](https://it.aliexpress.com/item/1005004742270942.html?spm=a2g0o.order_list.order_list_main.107.33a03696c66vOs&gatewayAdapt=glo2ita) for 2€.
160+
A couple of pictures zooming on the programmer itself and then its connections to the ESP32 relay board:
161+
162+
<img title="Programmer" alt="Prorgammer" src="images/programmer.jpg">
163+
<img title="Programmer" alt="Prorgammer" src="images/programmer_connection.jpg">
164+
165+
Once physical connection is ready, you will be able to install ESPHome initial firmware:
166+
167+
1. Log on your HomeAssistant and go to the ESPHome web interface
168+
2. Create a new device, copy-pasting the [example-instance.yaml](./example-instance.yaml)
169+
3. Launch "Validate" from the 3-dots menu for your new ESPHome device
170+
4. Launch "Install" from the 3-dots menu for your new ESPHome device and choose "Plug into this computer" option:
171+
172+
173+
<img title="Programmer" alt="Prorgammer" src="images/programmer_esphome.png.jpg">
174+
175+
After successful flashing you should be able to see logs coming from your board and, if the Wifi credentials
176+
are OK, your board should appear in the list of DHCP clients of your DHCP server.
177+
178+
147179
## TODO
148180

149181
* Write the [external component](https://esphome.io/components/external_components/) that will make it possible to control relays using the local temp sensor when connection to HA fails.

images/programmer.jpg

4.18 MB
Loading

images/programmer_connection.jpg

4.08 MB
Loading

images/programmer_esphome.png

35 KB
Loading

0 commit comments

Comments
 (0)