esphome-weatherman-dashboard-escreen/README.md

# Weatherman Dashboard for ESPHome

I have [multiple dashboards](https://github.com/Madelena/hass-config-public) around my apartment and they display different information depending on the context. Since this is placed near the front door, it contains concise information for what's outside with a homey style to match the rest of the wall.

<img src="https://user-images.githubusercontent.com/4341881/176365452-1e027b60-142e-4263-927b-b97c324edfd0.jpeg" width="66%" alt="Context"/>

This is part of the ecosystem for [my Home Assistant configuration](https://github.com/Madelena/hass-config-public).

## Hardware

- [Waveshare 7.5" e-Paper Screen](https://amzn.to/3R1tTyS) - 640x384 display resolution
- [Waveshare Universal e-Paper Driver Board with ESP32](https://amzn.to/3nkMRT8)
- [Ikea RIBBA Picture Frame 5"x7"](https://amzn.to/3QM3Zip)
- [Legrand 3 Way Switch + USB](https://amzn.to/3u7EKNz)
- [Micro USB Thin Ribbon Cable](https://amzn.to/3AatofQ)
- [Angled USB Thin Ribbon Cable](https://amzn.to/3blAhQT)

<img src="https://user-images.githubusercontent.com/4341881/176365459-4c61855c-7ade-44d9-84c6-0bb3b22b0b67.jpeg" width="66%" alt="Closeup"/>

## Software

- ESPHome
- Home Assistant running on a Raspberry Pi as a remote server

## Installation

1. No soldering is required since the e-Paper driver board was integrated into the ESP32 board. All I needed to do was to connect the e-Paper screen to the driver board, and then connect the driver board to the USB socket on my light switch.
2. Copy `/fonts`, `/images`, and `weatherman.yaml` to your /.config/esphome folder.
3. Integrate the content of `sensor.yaml` to your Home Assistant template configuration YAML file.
4. Install HA-GTFS-RT to your Home Assistant using HACS.
5. Once booted, flash `weatherman.yaml` the ESP32 board using ESPHome.
6. Enjoy!

## Data Sources

- Metno Hourly Weather Forecast HA integration
- Goodservice.io API
- [GTFS-RT Custom Component](https://github.com/zacs/ha-gtfs-rt)

## References

Here are some other repos that I referenced from:
- https://github.com/DeastinY/esphome-waveshare-e-paper-dashboard
- https://github.com/savikko/smarthome

*Weatherman* is a reference to the song *Blame it on the Weatherman* by B*Witched. If you're late to your date because of this, blame it on the Weatherman.