growlph/waveshare-panel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

PCB v2 Mockup

Browse Source
This commit is contained in:
Growlph
2026-08-12 11:10:38 -07:00
parent bcc155fd59
commit 3ce204a5d4
7 changed files with 229322 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
waveshare.yaml
+438
View File
@@ -0,0 +1,438 @@
# Andrew Villeneuve 2026/05
# Waveshare 2.9inch Touch ePaper HAT integration demo
#
# Platform: https://www.waveshare.com/2.9inch-Touch-e-Paper-HAT.htm
#
# Pin mappings
# ---
# |Function |ESP Pin |HAT Pin |Wire |
# |--- |--- |--- |--- |
# |5V |VIN |Pin2/5V |Red |
# |GND |GND |Pin6/GND |Blk |
# |Display SCLK |GPIO18 |Pin23/GPIO11/SPI0_SCLK |Blue |
# |Display MOSI |GPIO23 |Pin19/GPIO10/SPI0_MOSI |Green |
# |Display CS |GPIO19 |Pin24/GPIO8/SPI0_CE0 |Mgnta |
# |Display DC |GPIO17 |Pin22/GPIO25 |White |
# |Display Busy |GPIO4 |Pin18/GPIO24 |Brown |
# |Display RST |GPIO5 |Pin11/GPIO17/SPI1_CE1 |Orange |
# |Touch SDA |GPIO21 |Pin3/GPIO2/I2C1_SDA |Gray |
# |Touch SCL |GPIO22 |Pin5/GPIO3/I2C1_SCL |Purple |
# |Touch RST |GPIO15 |Pin13/GPIO27 |Blue |
# |Touch INT |GPIO16 |Pin15/GPIO22 |White |
#
# DISP_RST Moves from GPIO5 -> GPIO25 on PCB to avoid potential
# strapping issue
# TOUCH_IRQ Moves from GPIO16 -> GPIO14 on PCB to avoid potential
# strapping issue
#
# Exposed Entities
# ---
#
### Boilerplate ###
esphome:
name: waveshare-epaper-switch
esp32:
board: nodemcu-32s
framework:
type: esp-idf
# Enable logging
logger:
level: INFO
# Enable Home Assistant API
api:
encryption:
key: !secret enckey
ota:
- platform: esphome
password: !secret apipw
wifi:
ssid: !secret wifi_ssid
password: !secret wappw
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: ${fallbackssid}
password: !secret hotspotpw
captive_portal:
### Setup Interfaces ###
# Display
spi:
clk_pin: GPIO18
mosi_pin: GPIO23
display:
# This platform is a custom_component forked from upstream waveshare_epaper
# but modified by Claude to support 2bpp greyscale
- platform: waveshare_epaper_2bit
id: display0
cs_pin: GPIO19
dc_pin: GPIO17
busy_pin: GPIO4
reset_pin: GPIO5
model: 2.90inv2-r2-2bpp
# model: 2.90inv2-r2
full_update_every: 30
rotation: 0°
auto_clear_enabled: false
update_interval: never
# Touchscreen
i2c:
id: i2c_bus
sda: GPIO21
scl: GPIO22
scan: false
touchscreen:
# This platform is a custom_component written from scratch by Claude
platform: icnt86x
id: touchscreen0
address: 0x48
reset_pin: GPIO15
update_interval: 50ms
calibration:
x_min: 0
x_max: 127
y_min: 0
y_max: 295
transform:
swap_xy: true
mirror_x: true
### Okay, now the Good Stuff ###
# Load some fonts for the display renderer
font:
- file: "FreeSans.ttf"
id: font1
size: 26
bpp: 2
- file: "FreeSans.ttf"
id: headerfont
size: 80
- file: "FreeSans.ttf"
id: console
size: 30
# Pull in some icons from the material design library
# https://pictogrammers.com/library/mdi/
image:
defaults:
transparency: chroma_key
invert_alpha: false
resize: 54x54
binary:
- file: "mdi:home-lock-open"
id: home_lock_open
- file: "mdi:home-lock"
id: home_lock
- file: "mdi:ceiling-fan"
id: ceiling_fan
- file: "mdi:ceiling-fan-light"
id: ceiling_fan_light
- file: "mdi:fan-off"
id: fan_off
- file: "mdi:fan-speed-1"
id: fan_speed_1
- file: "mdi:fan-speed-2"
id: fan_speed_2
- file: "mdi:fan-speed-3"
id: fan_speed_3
- file: "mdi:floor-lamp-torchiere"
id: floor_lamp
- file: "mdi:home-off"
id: away_button
- file: "mdi:thermometer"
id: light_temp
# When the user taps the screen, introduce a small delay for the LVGL framebuffer
# to stabilize, then do a quick, 1-bit B/W selective update to visually indicate
# that a button was pushed.
#
# When the user is done interacting with the screen and several seconds have
# passed, do a slow, full-screen redraw at 2-bit grayscale.
script:
- id: refresh_display
mode: restart
then:
- delay: 80ms
- lambda: 'id(display0).display_partial();'
# Retry once the e-paper's busy window has cleared, to catch HA-synced
# widget updates that landed while the first partial refresh was in flight
# (display_partial drops calls when busy).
- delay: 350ms
- lambda: 'id(display0).display_partial();'
- id: full_refresh_display
mode: restart
then:
- delay: 10s
- component.update: display0
binary_sensor:
# Force a full display refresh when we press the "boot" button on the devboard
- platform: gpio
pin:
number: GPIO0
mode:
input: true
pullup: true
inverted: true
id: boot_button
internal: true
on_click:
then:
- component.update: lvgl0
- delay: 1s
- component.update: display0
# List the actual home entitites that we want this panel to control here
- platform: homeassistant
id: alpha_bedroom_light
entity_id: light.alpha_bedroom_light
publish_initial_state: true
on_state:
then:
- lvgl.widget.update:
id: button_ceiling_fan_light
state:
checked: !lambda return x;
- platform: homeassistant
id: alpha_bedroom_ceiling_fan
entity_id: fan.alpha_bedroom_ceiling_fan
publish_initial_state: true
on_state:
then:
- lvgl.widget.update:
id: button_ceiling_fan
state:
checked: !lambda return x;
sensor:
# Track the fan's current percentage so the speed buttons reflect the
# actual HA state (including changes made via other controls).
- platform: homeassistant
id: alpha_bedroom_ceiling_fan_pct
entity_id: fan.alpha_bedroom_ceiling_fan
attribute: percentage
on_value:
then:
- lvgl.widget.update:
id: button_fan_1
state:
checked: !lambda 'return x >= 1 && x < 50;'
- lvgl.widget.update:
id: button_fan_2
state:
checked: !lambda 'return x >= 50 && x < 84;'
- lvgl.widget.update:
id: button_fan_3
state:
checked: !lambda 'return x >= 84;'
# Here's where we put the actual GUI layout
lvgl:
- id: lvgl0
displays:
- display0
touchscreens:
- touchscreen0
on_draw_end:
- script.execute: refresh_display
- script.execute: full_refresh_display
# Black: 0x000000
# Dark Grey: 0x555555
# Light Grey: 0xAAAAAA
# White: 0xFFFFFF
bg_color: 0x000000
theme:
button:
bg_color: 0xFFFFFF
text_color: 0x000000
height: 60
width: 64
pad_all: 0
border_width: 2
border_color: 0x000000
checked:
bg_color: 0x888888
align: CENTER
obj:
bg_color: 0xFFFFFF
widgets:
- obj:
width: 100%
height: 100%
scrollable: false
pad_all: 0
# pad_row: 0
# pad_column: 0
border_width: 0
bg_color: 0xFFFFFF
layout:
type: GRID
grid_rows: [fr(1), fr(1), fr(1), fr(1)]
grid_columns: [fr(1), fr(1)]
widgets:
# Row 1: Light on/off (full width)
- button:
id: button_ceiling_fan_light
grid_cell_row_pos: 0
grid_cell_column_pos: 0
grid_cell_column_span: 2
grid_cell_x_align: STRETCH
width: 124
on_click:
- logger.log: "ceiling_fan_light"
- homeassistant.action:
action: light.toggle
data:
entity_id: light.alpha_bedroom_light
checkable: true
widgets:
- image:
src: ceiling_fan_light
align: CENTER
# Row 2: Fan on/off (full width)
- button:
id: button_ceiling_fan
grid_cell_row_pos: 1
grid_cell_column_pos: 0
grid_cell_column_span: 2
grid_cell_x_align: STRETCH
width: 124
on_click:
- logger.log: "ceiling_fan"
- homeassistant.action:
action: fan.toggle
data:
entity_id: fan.alpha_bedroom_ceiling_fan
checkable: true
widgets:
- image:
src: ceiling_fan
align: CENTER
# Row 3: Light temperature | Fan low
- button:
id: button_light_temp
grid_cell_row_pos: 2
grid_cell_column_pos: 0
on_click:
- logger.log: "light_temp"
- homeassistant.action:
action: button.press
data:
entity_id: button.alpha_bedroom_color_temp
widgets:
- image:
src: light_temp
align: CENTER
- button:
id: button_fan_1
grid_cell_row_pos: 2
grid_cell_column_pos: 1
checkable: true
on_click:
- logger.log: "fan_speed_1"
- homeassistant.action:
action: fan.set_percentage
data:
entity_id: fan.alpha_bedroom_ceiling_fan
percentage: '33'
- lvgl.widget.update:
id: button_fan_2
state:
checked: false
- lvgl.widget.update:
id: button_fan_3
state:
checked: false
widgets:
- image:
src: fan_speed_1
# Row 4: Fan medium | Fan high
- button:
id: button_fan_2
grid_cell_row_pos: 3
grid_cell_column_pos: 0
on_click:
- logger.log: "fan_speed_2"
- homeassistant.action:
action: fan.set_percentage
data:
entity_id: fan.alpha_bedroom_ceiling_fan
percentage: '66'
- lvgl.widget.update:
id: button_fan_1
state:
checked: false
- lvgl.widget.update:
id: button_fan_3
state:
checked: false
checkable: true
widgets:
- image:
src: fan_speed_2
- button:
id: button_fan_3
grid_cell_row_pos: 3
grid_cell_column_pos: 1
on_click:
- logger.log: "fan_speed_3"
- homeassistant.action:
action: fan.set_percentage
data:
entity_id: fan.alpha_bedroom_ceiling_fan
percentage: '100'
- lvgl.widget.update:
id: button_fan_1
state:
checked: false
- lvgl.widget.update:
id: button_fan_2
state:
checked: false
checkable: true
widgets:
- image:
src: fan_speed_3
# Unused buttons — kept defined but hidden for future use
- obj:
hidden: true
width: 1
height: 1
border_width: 0
pad_all: 0
widgets:
- button:
id: button_fan_off
on_click:
- logger.log: "fan_off"
checkable: true
widgets:
- image:
src: fan_off
- button:
id: button_floor_lamp
on_click:
- logger.log: "floor_lamp"
checkable: true
widgets:
- image:
src: floor_lamp
- button:
id: button_away
on_click:
- logger.log: "away_button"
checkable: true
widgets:
- image:
src: away_button