HomePlate

Home Assistant E-Ink Dashboard on the Inkplate 10

Activities Screenshots

Features

• Display Home Assistant dashboards on a beautiful e-ink display
• Display WiFi QR Codes for guests/friends to connect to home/guest wifi
• Can display messages directly from Home Assistant over MQTT
• Makes full use of the ESP32's cores with FreeRTOS
• Reports sensor data to Home Assistant over MQTT (Temperature, Battery, WiFi, etc..)
• Can change Activity displayed via MQTT Command (HASS dashboard, WiFi QR, Stats, text message, etc..)
• Syncs RTC over NTP
• Touch-pad buttons can start activities and wake from sleep
• 1 month+ battery life!
• Low battery warning displayed and sent over MQTT
• OTA updates over WiFi
• Partial screen updates in grayscale mode.
• Power saving sleep mode.
• Display any PNG image from MQTT Command

Future Ideas

• Incorporate WiFi Manager for settings

Setup

Hardware

See hardware.md

Home Assistant Dashboard

Create a Home Assistant Dashboard you want to display. I recommend using the kiosk-mode, card-mod and layout-card plugins to customize and tune the dashboard for your display.

Setup sibbl's hass-lovelace-kindle-screensaver or my fork hass-screenshot to regularly screenshot the desired dashboards for the HomePlate.

More information in hass.md and dashboard.md

Inkplate

Install PlatformIO. Then copy src/config_example.h to src/config.h and enter your settings.

Build & run with:

pio run

The first flash/installation needs to be done over USB. Future updates can be done over USB or WiFi with:

pio run -e ota

To monitor serial output without re-flashing:

pio device monitor

Updating

git pull
pio upgrade
pio pkg update
pio run --target clean

Debugging

If you get the following error while booting your inkplate, run the Inkplate_Wavefrom_EEPROM_Programming example to update your Inkplate's waveform.

Waveform load failed! Upload new waveform in EEPROM. Using default waveform.

Older Inkplates don't appear to ship with an updated waveform. I found waveform 3 looks the best for mine.