Skip to main content

Flashing the Firmware

Flashing happens in two phases: a first one-time flash over USB to get the device online, then the Superhome configuration installed wirelessly.

Steps​

1. Install ESPHome in Home Assistant​

Settings → Apps → Install app → search ESPHome Device Builder → Install → Start.

2. First flash over USB (ESPHome Web)​

This first flash is done from your computer over USB, not from the machine running Home Assistant.

Use Google Chrome

The web flasher only works in Google Chrome. Connect the ESP32 display via USB to the computer where you open Chrome, not to the HAOS machine.

  1. Open the ESPHome dashboard and click New Device.
  2. On the page that opens, click Open ESPHome Web, then Connect.
  3. Select the display from the serial-port list, then choose Prepare for first use and let it install.
  4. Follow the prompts to connect the device to your WiFi. Use the same network that Home Assistant runs on.

3. Adopt the device in ESPHome​

Go back to the ESPHome Builder in Home Assistant. A banner appears at the top saying a new device was discovered.

  1. Click Show, then Take control, and give it any name you like.
  2. Install the configuration ESPHome proposes.
  3. Wait until the logs show the device connected to your network and the line Boot seems successful; resetting boot loop counter.

4. Apply the Superhome configuration​

  1. In the ESPHome Builder, click Edit on the device and replace the content with the YAML from esphome-gesture-display.yml in the Superhome repository. Keep the WiFi credentials and the API encryption key that ESPHome set up for this device (the YAML references them through secrets).
  2. For stability and fewer connection errors, we recommend setting a static IP in the manual_ip block of the YAML. If you'd rather use DHCP, remove the manual_ip block instead.
  3. Click Save, then Install → Wirelessly.
  4. This takes a while. When it finishes, the device reconnects and the logs again show Boot seems successful; resetting boot loop counter. You can then click Stop. This only closes the log window; it does not stop the display.

5. Add to Home Assistant​

In Home Assistant → Settings → Devices, the display is discovered automatically. Add it. To confirm it works, open the device and toggle its backlight entity: the screen should turn on and off.

6. Place the display​

Unplug the display from your computer, put it wherever you want, and power it over USB-C. It reconnects to WiFi on its own and starts subscribing to the sensor.superhome_* sensors.