pulimento / TTGO-T-Display-esphome-sample

ESPHome template to show HomeAssistant sensor data in a TTGO T-Display

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TTGO T-Display sample

This sample uses TTGO ESP32 T-Display board, optionally powered by a battery, with ESPHome, alongside with Home Assistant

This sample features:

  • The built-in OLED display (showing some sensors data)
  • GPIO buttons
  • Li-Po battery charge data
  • R/W communication with HomeAssistant

Currently, it uses custom components from musk95, but there is a pull request in esphome project that adds support for this display. Neverthless, code in this repo will continue to work.

Initially, it used a custom component for the display. As of today (mid 2021), ESPHome has native support for this screen, so no custom component required.

Pinout

Pin map

Usage

Make sure you have ESPHome CLI installed previously. If not, here are the instructions

  • In the root folder, create a secrets.yaml file (in this case, for wifi credentials). Example file included
  • Change ttg.yaml accordingly
  • Connect your device via USB (if powered by a battery, OTA flashing is possible, thus USB is not needed)
  • Run: esphome ttg.yaml run (or compile, upload or whatever)
  • Profit!

Future ideas in mind

  • Underclock ESP? Possible from C++. ESP32.cpp, ESP.getCpuFreqMHz(). Could also be set.
  • Power off screen (viewing this PR, it would be possible to digitally disable the backlight
  • Pages (I've started trying it, in ttg-pages.yaml)
  • Report battery correctly when charging

About

ESPHome template to show HomeAssistant sensor data in a TTGO T-Display