Files

T

Max Gramser 94546cf727 Add stable CYD firmware, USB calibration wizard and complete setup guide

2026-09-12 10:18:49 +02:00

24 KiB

Raw Blame History

Nieuwe ESP32-2432S028-installatie: begin bij README.md en de actuele tegelhandleiding. Hieronder staat ook legacygedrag.

Tile Configuration Reference

For the ESP32-2432S028 profile, use home-like-2432s028.yaml and CYD_STABILITY.md. That profile uses fixed pages instead of scrolling, hides pagination when TILE_COUNT <= 6, and dims after ten minutes. The scrolling description below applies to home-like.yaml.

This document explains every substitution in home-like.yaml and provides copy-paste examples for all supported entity types.

How substitutions work

ESPHome substitutions are compile-time text replacements. There is no runtime logic in the substitution block — every ${TILE1_...} reference in the YAML is replaced with the value you set before the firmware is compiled and flashed. This means:

You cannot use if/else in substitutions
Changes require a reflash
The firmware is fully self-contained after flashing

The home screen scrolls

The wallpaper, the room name and the clock sit on the page itself and stay put. All tiles live inside one transparent container (tile_scroll) that scrolls vertically, so the grid can be taller than the screen.

The grid is 2 columns x 5 rows = 10 tiles. Rows 1-3 are visible at rest; dragging up reveals rows 4 and 5.
GRID_ROW*_Y are relative to the scroll container, not to the page. SCROLL_Y / SCROLL_H define where the container sits and how tall the viewport is. Both are set per orientation preset.
LVGL derives the scroll length from the tile positions, so there is no content height to maintain by hand.
Tapping and scrolling do not conflict: once a drag passes LVGL's scroll limit (10 px) the short click and the long press are cancelled.
scroll_snap_y: START makes the container click into place per row. Set it to NONE on the tile_scroll object for free scrolling.

Background

The background is a two-stop vertical gradient (BG_TOP_COLOR -> BG_BOTTOM_COLOR), not an image. That saves ~150 KB of flash and removes an image blit from every redraw, which is what makes scrolling usable on this board. The same gradient is reused as the backdrop of the slider, color and thermostat overlays through the style_bg_grad style.

Accent colors are automatic

A tile's accent color is derived from the Home Assistant domain — the part of the entity id before the dot:

Entity	Domain	Accent
`script.goede_morgen`	`script`	`ACCENT_ACTION` (violet)
`scene.avondlicht`	`scene`	`ACCENT_ACTION` (violet)
`light.woonkamer_2`	`light`	`ACCENT_LIGHT` (amber)
`vacuum.s8`	`vacuum`	`ACCENT_DEVICE` (cyan)
`climate.airco`	`climate`	`ACCENT_DEVICE` (cyan)

The distinction that matters: a script or scene is something you fire, a device is something you switch on and off. Those should not look the same.

Two of the ten per-tile color keys participate: TILE*_CIRCLE_ACTIVE_COLOR and TILE*_ICON_DISABLED_COLOR. Set them to ${ACCENT_AUTO} to let the domain decide — that is the default for every tile — or to a real hex value to override that one tile. Tile 8 does exactly that: the mailbox turns red when there is post, regardless of its domain.

Because the color follows the entity, dropping a different entity into a tile gives it the right color without touching any color key.

The domain lookup lives in a small accent_for lambda that appears twice in home-like.yaml: once in ui_refresh (for the tiles) and once in open_value_overlay (for the slider fill). Keep the two copies in sync.

Global settings

Key	Default	Description
`DIRECT_ACTIONS`	`"true"`	`true` = device calls HA services directly on tap. `false` = only publishes the action event, you handle it in HA automations.
`ROOM_NAME`	`"Office"`	Text shown in the top-left header.
`TIME_24H`	`"true"`	`true` = 24h clock, `false` = 12h with AM/PM.
`AUTO_DIM`	`"true"`	Enable backlight auto-dimming after inactivity.
`AUTO_DIM_TIMEOUT`	`"10"`	Seconds of no touch before dimming.
`MAX_BRIGHTNESS`	`"100"`	Backlight brightness (%) when active.
`DIM_BRIGHTNESS`	`"40"`	Backlight brightness (%) when dimmed.
`NIGHT_MODE`	`"true"`	Use a lower brightness level during night hours.
`NIGHT_START_HOUR`	`"22"`	Hour (0–23) when night mode starts.
`NIGHT_END_HOUR`	`"7"`	Hour (0–23) when night mode ends.
`NIGHT_DIM_BRIGHTNESS`	`"18"`	Backlight brightness (%) during night hours.
`BG_TOP_COLOR`	`"0xAEC4D9"`	Top color of the background gradient.
`BG_BOTTOM_COLOR`	`"0xD6BB9E"`	Bottom color of the background gradient.
`ACCENT_AUTO`	`"0x1000000"`	Sentinel meaning "derive this color from the entity domain". Deliberately outside the 24-bit color range.
`ACCENT_ACTION`	`"0x8B5CF6"`	Accent for `script`, `scene`, `button`, `input_button`, `automation`.
`ACCENT_LIGHT`	`"0xFEC600"`	Accent for `light`.
`ACCENT_DEVICE`	`"0x00C5EC"`	Accent for everything else (switch, fan, cover, climate, vacuum, media_player, …).

Per-tile substitutions

Each tile has the same set of keys, just with a different number (TILE1 … TILE10). All ten slots are in use — see Adding a tile if you want to extend the grid further.

Basic settings

Key	Description
`TILE*_ENTITY`	The Home Assistant entity this tile controls (e.g. `light.living_room`).
`TILE*_STATE_ENTITY`	Entity used to determine active/inactive visual state. Usually the same as `TILE*_ENTITY`. Set to a different entity if you want the tile to reflect a group or a related sensor.
`TILE*_TITLE`	Text label shown on the tile.
`TILE*_ICON`	Material Design Icons Unicode glyph. Find icons at pictogrammers.com/library/mdi — click an icon and copy the Unicode value (e.g. `U+F0769` → `"\U000F0769"`).
`TILE*_TYPE`	Entity type: `light` \| `fan` \| `switch` \| `scene` \| `script` \| `cover` \| `climate`. Controls tap behavior, value display, and slider type in auto mode.
`TILE*_TAP_ACTION`	What happens on short tap — see Tap actions below.
`TILE*_LONGPRESS`	What happens on long press — see Long press modes below.
`TILE*_VALUE_MODE`	How the value line below the title is rendered — see Value modes below.
`TILE*_LABEL_OFF`	Text shown in the value line when the entity is off / inactive.
`TILE*_LABEL_ON`	Text shown in the value line when `VALUE_MODE` is `text` and entity is on.
`TILE*_ACTIVE_STATE`	Optional. Exact Home Assistant state that counts as "active". Leave empty for the default behavior (`on`, or always-on for scenes/scripts). Used by tile 8, where the state is `Vol` / `Leeg` rather than `on` / `off`.

Colors

All colors are 24-bit hex in the format "0xRRGGBB".

Key	Description
`TILE*_CIRCLE_ACTIVE_COLOR`	Icon circle background when active. `${ACCENT_AUTO}` = derive from the entity domain.
`TILE*_CIRCLE_DISABLED_COLOR`	Icon circle background when inactive.
`TILE*_ICON_ACTIVE_COLOR`	Icon glyph color when active.
`TILE*_ICON_DISABLED_COLOR`	Icon glyph color when inactive. `${ACCENT_AUTO}` = derive from the entity domain.
`TILE*_BG_ACTIVE_COLOR`	Tile background when active.
`TILE*_BG_DISABLED_COLOR`	Tile background when inactive.
`TILE*_TITLE_ACTIVE_COLOR`	Title text color when active.
`TILE*_TITLE_DISABLED_COLOR`	Title text color when inactive.
`TILE*_VALUE_ACTIVE_COLOR`	Value text color when active.
`TILE*_VALUE_DISABLED_COLOR`	Value text color when inactive.

Advanced settings (short tap)

Key	Default	Description
`TILE*_TAP_SERVICE`	`""`	Override the HA service called on tap (e.g. `"light.toggle"`). Leave empty to use the default for the tile type.
`TILE*_TAP_PARAM_KEY`	`""`	Extra parameter key for the service call. Supported keys: `preset_mode`, `brightness_pct`, `percentage`, `option`. Any other value is ignored and the service is called with `entity_id` only.
`TILE*_TAP_PARAM_VAL`	`""`	Extra parameter value (e.g. `"Auto"`).

Advanced settings (long press — slider mode)

Only relevant when TILE*_LONGPRESS is set to "slider".

Key	Default	Description
`TILE*_LONGPRESS_SLIDER`	`"auto"`	Slider type: `auto` \| `brightness` \| `percentage` \| `cover_position` \| `climate_temperature`. `auto` picks the right type based on `TILE*_TYPE`.
`TILE*_LONGPRESS_OFF_VALUE`	`"0"`	Initial slider position (0–100) shown when the entity is currently off.

Advanced settings (climate tiles)

Only relevant when TILE*_TYPE is set to "climate".

Key	Default	Description
`TILE*_CLIMATE_MIN_TEMP`	`"5.0"`	Minimum target temperature shown in the thermostat overlay.
`TILE*_CLIMATE_MAX_TEMP`	`"30.0"`	Maximum target temperature shown in the thermostat overlay.
`TILE*_CLIMATE_STEP`	`"0.5"`	Step size for the thermostat ring and +/- buttons. Values below `0.5` are rounded up to `0.5`, so the UI always adjusts in whole or half-degree steps.
`TILE*_CLIMATE_CURRENT_TEMP_ATTRIBUTE`	`"current_temperature"`	Home Assistant attribute used for the current room temperature.
`TILE*_CLIMATE_TARGET_TEMP_ATTRIBUTE`	`"temperature"`	Home Assistant attribute used for the target temperature.
`TILE*_CLIMATE_HUMIDITY_ATTRIBUTE`	`"current_humidity"`	Home Assistant attribute used for humidity. Leave the default if the entity does not provide humidity.

Advanced settings (long press — action mode)

Only relevant when TILE*_LONGPRESS is set to "action".

Key	Default	Description
`TILE*_LONGPRESS_ACTION`	`""`	HA entity to call on long press. Can be completely different from `TILE*_ENTITY`.
`TILE*_LONGPRESS_ACTION_TYPE`	`""`	Entity type of the long press target: `light` \| `fan` \| `switch` \| `scene` \| `script` \| `cover`. Leave empty to inherit from `TILE*_TYPE`.
`TILE*_LONGPRESS_ACTION_SERVICE`	`""`	Service to call (default is `activate`/`turn_on`). Set e.g. `"light.toggle"` to toggle instead.

Tap actions

Value	Behavior
`auto`	Picks the best action for the tile type: `toggle` for light/fan/switch/cover, `activate` for scene/script. Climate tiles do not have a default tap action; use `TILE*_TAP_SERVICE` if you want short tap behavior.
`toggle`	Toggles the entity (light.toggle / fan.toggle / switch.toggle / cover open↔close).
`activate`	Turns on / activates the entity (scene.turn_on / script.turn_on / light.turn_on / cover.open_cover).
`fan_toggle_preset`	If fan is ON: turns it off. If fan is OFF: turns it on and sets a preset mode (configure with `TAP_PARAM_KEY` / `TAP_PARAM_VAL`).
`custom`	Use `TAP_SERVICE` + `TAP_PARAM_KEY` / `TAP_PARAM_VAL` for a fully custom service call.

Long press modes

Value	Behavior
`slider`	Opens a value overlay with a slider. Configure with `TILE_LONGPRESS_SLIDER` and `TILE_LONGPRESS_OFF_VALUE`.
`action`	Fires a different HA entity than the short tap. Configure with `TILE_LONGPRESS_ACTION`.
`none`	No direct action — only publishes `tileN_long_press` to HA so you can react in automations.

In all modes, the event tileN_long_press is always published to sensor.smartdisplay_action in Home Assistant.

For light tiles in slider mode, the brightness overlay automatically shows a color-ring button when DIRECT_ACTIONS is "true" and Home Assistant reports a supported color mode (hs, rgb, rgbw, rgbww, xy) or color temperature mode (color_temp). The color detail view can send light.turn_on with color_name, color_temp_kelvin, and the current brightness percentage. If the light only supports color or only supports color temperature, the Color/Temp tab switch is hidden and only the supported controls are shown. No extra tile substitutions are required.

For climate tiles in slider mode, the thermostat overlay sends climate.set_temperature with the configured target temperature. The min/max range, step size, and Home Assistant attribute names are configured through the TILE*_CLIMATE_* substitutions. The mode pill cycles through the climate entity's supported hvac_modes and sends climate.set_hvac_mode when DIRECT_ACTIONS is "true".

Value modes

Value	Behavior
`auto`	Picks automatically: `brightness` for lights, `percentage` or `preset` for fans, `climate` for climate entities, `text` for everything else.
`brightness`	Shows brightness as a percentage (e.g. `80 %`). When off, shows `LABEL_OFF`.
`percentage`	Shows fan speed as a percentage. When off, shows `LABEL_OFF`.
`preset`	Shows the fan preset_mode attribute. When off, shows `LABEL_OFF`.
`climate`	Shows the target temperature, falling back to current temperature if no target is available. When off, shows `LABEL_OFF`.
`text`	Shows `LABEL_ON` when on, `LABEL_OFF` when off. For scenes/scripts, always shows `LABEL_ON`.

Home Assistant events

Every tap publishes a short-lived state to sensor.smartdisplay_action:

Event	Trigger
`tile1_press` … `tile10_press`	Short tap on tile 1–10
`tile1_long_press` … `tile10_long_press`	Long press on tile 1–10

The state resets to "" after 500ms. In HA automations, trigger on state → to: "tile1_press" etc.

Complete examples

Light — toggle + brightness slider

TILE1_ENTITY: "light.living_room_ceiling"
TILE1_STATE_ENTITY: "light.living_room_ceiling"
TILE1_TITLE: "Ceiling"
TILE1_ICON: "\U000F0769"          # mdi:ceiling-light
TILE1_TYPE: "light"
TILE1_TAP_ACTION: "auto"          # toggles the light
TILE1_LONGPRESS: "slider"         # long press opens brightness slider
TILE1_VALUE_MODE: "auto"          # shows brightness % when on, "Off" when off
TILE1_LABEL_OFF: "Off"
TILE1_LABEL_ON: "On"
# colors
TILE1_CIRCLE_ACTIVE_COLOR: "0xFEC600"
TILE1_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE1_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE1_ICON_DISABLED_COLOR: "0xFEC600"
TILE1_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE1_BG_DISABLED_COLOR: "0x939391"
TILE1_TITLE_ACTIVE_COLOR: "0x000000"
TILE1_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE1_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE1_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced
TILE1_TAP_SERVICE: ""
TILE1_TAP_PARAM_KEY: ""
TILE1_TAP_PARAM_VAL: ""
TILE1_LONGPRESS_SLIDER: "auto"    # auto = brightness for lights
TILE1_LONGPRESS_OFF_VALUE: "0"
TILE1_LONGPRESS_ACTION: ""
TILE1_LONGPRESS_ACTION_TYPE: ""
TILE1_LONGPRESS_ACTION_SERVICE: ""

Switch — simple toggle, no slider

TILE2_ENTITY: "switch.office_power_strip"
TILE2_STATE_ENTITY: "switch.office_power_strip"
TILE2_TITLE: "Power Strip"
TILE2_ICON: "\U000F06FF"          # mdi:power-socket-eu
TILE2_TYPE: "switch"
TILE2_TAP_ACTION: "auto"          # toggles the switch
TILE2_LONGPRESS: "none"           # long press only sends event, no slider
TILE2_VALUE_MODE: "text"          # shows "On" / "Off"
TILE2_LABEL_OFF: "Off"
TILE2_LABEL_ON: "On"
# colors
TILE2_CIRCLE_ACTIVE_COLOR: "0xFEC600"
TILE2_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE2_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE2_ICON_DISABLED_COLOR: "0xFEC600"
TILE2_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE2_BG_DISABLED_COLOR: "0x939391"
TILE2_TITLE_ACTIVE_COLOR: "0x000000"
TILE2_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE2_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE2_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced
TILE2_TAP_SERVICE: ""
TILE2_TAP_PARAM_KEY: ""
TILE2_TAP_PARAM_VAL: ""
TILE2_LONGPRESS_SLIDER: "auto"
TILE2_LONGPRESS_OFF_VALUE: "0"
TILE2_LONGPRESS_ACTION: ""
TILE2_LONGPRESS_ACTION_TYPE: ""
TILE2_LONGPRESS_ACTION_SERVICE: ""

Cover — open/close toggle + position slider

TILE3_ENTITY: "cover.living_room_blinds"
TILE3_STATE_ENTITY: "cover.living_room_blinds"
TILE3_TITLE: "Blinds"
TILE3_ICON: "\U000F111C"          # mdi:blinds
TILE3_TYPE: "cover"
TILE3_TAP_ACTION: "auto"          # opens if closed, closes if open
TILE3_LONGPRESS: "slider"         # long press opens position slider
TILE3_VALUE_MODE: "auto"          # shows "Open" / "Closed" (text mode for covers)
TILE3_LABEL_OFF: "Closed"
TILE3_LABEL_ON: "Open"
# colors — blue theme for covers
TILE3_CIRCLE_ACTIVE_COLOR: "0x00C5EC"
TILE3_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE3_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE3_ICON_DISABLED_COLOR: "0x00C5EC"
TILE3_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE3_BG_DISABLED_COLOR: "0x939391"
TILE3_TITLE_ACTIVE_COLOR: "0x000000"
TILE3_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE3_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE3_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced
TILE3_TAP_SERVICE: ""
TILE3_TAP_PARAM_KEY: ""
TILE3_TAP_PARAM_VAL: ""
TILE3_LONGPRESS_SLIDER: "auto"    # auto = cover_position for covers
TILE3_LONGPRESS_OFF_VALUE: "0"
TILE3_LONGPRESS_ACTION: ""
TILE3_LONGPRESS_ACTION_TYPE: ""
TILE3_LONGPRESS_ACTION_SERVICE: ""

Fan — toggle preset on tap + speed slider on long press

TILE4_ENTITY: "fan.air_purifier"
TILE4_STATE_ENTITY: "fan.air_purifier"
TILE4_TITLE: "Purifier"
TILE4_ICON: "\U000F0D43"          # mdi:air-purifier
TILE4_TYPE: "fan"
TILE4_TAP_ACTION: "fan_toggle_preset"  # off→on with preset, on→off
TILE4_LONGPRESS: "slider"              # long press opens speed slider
TILE4_VALUE_MODE: "auto"               # shows preset name when on, "Off" when off
TILE4_LABEL_OFF: "Off"
TILE4_LABEL_ON: "On"
# colors — blue theme for fan
TILE4_CIRCLE_ACTIVE_COLOR: "0x00C5EC"
TILE4_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE4_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE4_ICON_DISABLED_COLOR: "0x00C5EC"
TILE4_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE4_BG_DISABLED_COLOR: "0x939391"
TILE4_TITLE_ACTIVE_COLOR: "0x000000"
TILE4_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE4_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE4_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced — fan_toggle_preset requires SERVICE + PARAM
TILE4_TAP_SERVICE: "fan.toggle"
TILE4_TAP_PARAM_KEY: "preset_mode"
TILE4_TAP_PARAM_VAL: "Auto"       # preset to activate when turning on
TILE4_LONGPRESS_SLIDER: "auto"    # auto = percentage for fans
TILE4_LONGPRESS_OFF_VALUE: "0"
TILE4_LONGPRESS_ACTION: ""
TILE4_LONGPRESS_ACTION_TYPE: ""
TILE4_LONGPRESS_ACTION_SERVICE: ""

Climate — thermostat ring on long press

TILE5_ENTITY: "climate.living_room"
TILE5_STATE_ENTITY: "climate.living_room"
TILE5_TITLE: "Living"
TILE5_ICON: "\U000F0438"          # mdi:radiator
TILE5_TYPE: "climate"
TILE5_TAP_ACTION: "auto"          # no default tap action; use TAP_SERVICE if desired
TILE5_LONGPRESS: "slider"         # long press opens thermostat ring
TILE5_VALUE_MODE: "auto"          # shows target temperature, or current temperature as fallback
TILE5_LABEL_OFF: "Off"
TILE5_LABEL_ON: "Heat"
# colors
TILE5_CIRCLE_ACTIVE_COLOR: "0xFF9F0A"
TILE5_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE5_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE5_ICON_DISABLED_COLOR: "0xFF9F0A"
TILE5_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE5_BG_DISABLED_COLOR: "0x939391"
TILE5_TITLE_ACTIVE_COLOR: "0x000000"
TILE5_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE5_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE5_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced
TILE5_TAP_SERVICE: ""
TILE5_TAP_PARAM_KEY: ""
TILE5_TAP_PARAM_VAL: ""
TILE5_LONGPRESS_SLIDER: "auto"    # auto = climate_temperature for climate tiles
TILE5_LONGPRESS_OFF_VALUE: "0"
TILE5_LONGPRESS_ACTION: ""
TILE5_LONGPRESS_ACTION_TYPE: ""
TILE5_LONGPRESS_ACTION_SERVICE: ""
TILE5_CLIMATE_MIN_TEMP: "5.0"
TILE5_CLIMATE_MAX_TEMP: "30.0"
TILE5_CLIMATE_STEP: "0.5"
TILE5_CLIMATE_CURRENT_TEMP_ATTRIBUTE: "current_temperature"
TILE5_CLIMATE_TARGET_TEMP_ATTRIBUTE: "temperature"
TILE5_CLIMATE_HUMIDITY_ATTRIBUTE: "current_humidity"

Scene — activate on tap

TILE6_ENTITY: "scene.movie_night"
TILE6_STATE_ENTITY: "scene.movie_night"  # scenes are always "on" so the tile stays active-styled
TILE6_TITLE: "Movie"
TILE6_ICON: "\U000F0E8B"          # mdi:movie-open
TILE6_TYPE: "scene"
TILE6_TAP_ACTION: "auto"          # activates the scene
TILE6_LONGPRESS: "none"
TILE6_VALUE_MODE: "text"          # always shows LABEL_ON for scenes
TILE6_LABEL_OFF: "Scene"
TILE6_LABEL_ON: "Scene"
# colors — green theme
TILE6_CIRCLE_ACTIVE_COLOR: "0x4CAF50"
TILE6_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE6_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE6_ICON_DISABLED_COLOR: "0x4CAF50"
TILE6_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE6_BG_DISABLED_COLOR: "0x939391"
TILE6_TITLE_ACTIVE_COLOR: "0x000000"
TILE6_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE6_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE6_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced
TILE6_TAP_SERVICE: ""
TILE6_TAP_PARAM_KEY: ""
TILE6_TAP_PARAM_VAL: ""
TILE6_LONGPRESS_SLIDER: "auto"
TILE6_LONGPRESS_OFF_VALUE: "0"
TILE6_LONGPRESS_ACTION: ""
TILE6_LONGPRESS_ACTION_TYPE: ""
TILE6_LONGPRESS_ACTION_SERVICE: ""

Script — run on tap

TILE6_ENTITY: "script.good_morning"
TILE6_STATE_ENTITY: "script.good_morning"
TILE6_TITLE: "Morning"
TILE6_ICON: "\U000F0A72"          # mdi:weather-sunny
TILE6_TYPE: "script"
TILE6_TAP_ACTION: "auto"          # runs the script
TILE6_LONGPRESS: "none"
TILE6_VALUE_MODE: "text"
TILE6_LABEL_OFF: "Run"
TILE6_LABEL_ON: "Run"
# colors — orange theme
TILE6_CIRCLE_ACTIVE_COLOR: "0xFF6F00"
TILE6_CIRCLE_DISABLED_COLOR: "0x7B7B6F"
TILE6_ICON_ACTIVE_COLOR: "0xFFFFFF"
TILE6_ICON_DISABLED_COLOR: "0xFF6F00"
TILE6_BG_ACTIVE_COLOR: "0xFFFFFF"
TILE6_BG_DISABLED_COLOR: "0x939391"
TILE6_TITLE_ACTIVE_COLOR: "0x000000"
TILE6_TITLE_DISABLED_COLOR: "0xFFFFFF"
TILE6_VALUE_ACTIVE_COLOR: "0x7A7A7C"
TILE6_VALUE_DISABLED_COLOR: "0xD9D9D9"
# advanced
TILE6_TAP_SERVICE: ""
TILE6_TAP_PARAM_KEY: ""
TILE6_TAP_PARAM_VAL: ""
TILE6_LONGPRESS_SLIDER: "auto"
TILE6_LONGPRESS_OFF_VALUE: "0"
TILE6_LONGPRESS_ACTION: ""
TILE6_LONGPRESS_ACTION_TYPE: ""
TILE6_LONGPRESS_ACTION_SERVICE: ""

Long press — call a different entity

Short tap toggles a light; long press activates a scene.

TILE1_ENTITY: "light.living_room"
TILE1_TYPE: "light"
TILE1_TAP_ACTION: "auto"           # short tap: toggle the light
TILE1_LONGPRESS: "action"          # long press: fire a different entity
# ...
TILE1_LONGPRESS_ACTION: "scene.movie_night"
TILE1_LONGPRESS_ACTION_TYPE: "scene"
TILE1_LONGPRESS_ACTION_SERVICE: "" # empty = default activate for scene

Short tap toggles a light; long press also toggles a different light.

TILE1_LONGPRESS: "action"
TILE1_LONGPRESS_ACTION: "light.bedroom"
TILE1_LONGPRESS_ACTION_TYPE: ""    # empty = inherits "light" from TILE1_TYPE
TILE1_LONGPRESS_ACTION_SERVICE: "light.toggle"  # must set toggle explicitly, default is turn_on

Adding a tile

All ten slots are filled. To grow the grid, add a GRID_ROW6_Y to every orientation preset first. A tile is not a single block — it is six places in home-like.yaml. Copy tile 9 (a light with a slider) or tile 10 (a service call) and change the number:

Substitutions — a TILE9_* block. Copy an existing one wholesale.
Font glyph — add MDI_GLYPH_9 and list it under materialdesign_icons. A glyph that is not listed renders as blank space.
Sensors — under sensor: / text_sensor:. ha_state_tile9 is the only required one. Add the rest only if the tile actually uses them: tile9_brightness (light), tile9_percentage + tile9_preset (fan), tile9_cover_position + tile9_cover_state (cover), tile9_climate_* (climate), tile9_supported_color_modes (color light). Every subscription costs heap, so skip what the tile does not read.
Widget — an obj under tile_scroll's widgets:, at x: ${GRID_COL1_X} / y: ${GRID_ROW5_Y}. Pass NAN (floats) or "" (strings) to open_value_overlay for any sensor you skipped in step 3.
Ack script — a tile9_ack copy under script:.
Refresh lambda — three lines in ui_refresh: a t9_on line next to the others, a set_value_auto(id(t9_value), …) call, and an apply_tile(t9_on, …) call. Climate tiles also need a sync_open_climate line.

Watch sensor.*_heap_free in Home Assistant after flashing. This board has no PSRAM, so free heap is the real ceiling on how many tiles fit.

Finding Material Design Icons

Go to pictogrammers.com/library/mdi
Search for an icon name
Click the icon → copy the Unicode codepoint (e.g. F0769)
Format it as "\U000F0769" (always 8 hex digits, padded with leading zeros)

Make sure the glyph is listed in the glyphs: section of the MDI font definition in the YAML (search for materialdesign_icons). If you use an icon that is not listed there, it will show as a blank space.

24 KiB Raw Blame History Unescape Escape