Skip to main content

ESPHome ESP32 Install Procedures

To create your initial ESPHome config for the device. On the ESPHome Dashboard

alt text

Click + New Device, hit Continue, and give it a unique name.

alt text

Choose the Correct Variant/Board type

alt text

Click Install or choose Skip if you plan on making changes to the default YAML config on this device

alt text

Select Manual Download

alt text

Select Modern Format - DO NOT Select Legacy

alt text

The device config will compile and download the bin to the computer default dwonload folder you are working on.

alt text

Click Close to return to the ESPHome Dashboard.

How to Install/Flash the Modern/Factory bin of ESPHome

There are two methods. Choose the one you are more comfortable with. Browser based ESPHome Web Flasher (easiest) or ESPTool.py command line. Connect the device and ensure it is ready for installation/flashing. Some devices require GPIO 0 to be held to ground, some require the Boot button to be held and some simply need to be plugged into USB. This will vary per device.

Note: After this intial flash/install, all updates/changes can be done via the "Update via Network" option without using this manual method of plugging in the device to the computer/host.

Install the ESPHome Factory bin via a Web Browser

Open an additional tab to ESPHome Web Tools https://web.esphome.io/

Click Connect and select the USB TTL adapter connected. If you do not see one listed, follow the on screen help to load the correct drivers.

alt text

Select Install. Choose File button, browse to the bin previously downloaded from the compile procedure above and select install.

alt text

Hurry up and Wait! Some devices might require you to unplug and plug in the device to cycle power for them to boot up. If you have GPIO 0 held to ground please remove this before trying to boot up the device into ESPHome. Any additional updates/changes to the conifguration of the device can be done via the network update option. Congratulations! 🎉

alt text

Install the ESPHome Factory bin via ESPTool.py

ESPTool.py python tool is required and needs to be installed on the host machine. ESPTool.py installation procedure

esptool.py write_flash 0x0 your_esp32-factory.bin

Note: If you receive an error, try lowering the baud rate to 115200 or slower by adding the --baud 115200 parameter.

Some devices might require you to unplug and plug in the device to cycle power for them to boot up. If you have GPIO 0 held to ground please remove this before trying to boot up the device into ESPHome. Any additional updates/changes to the conifguration of the device can be done via the network update option. Congratulations! 🎉