Max Gramser
ae308e37ab
Home Assistant shows an ESPHome device action with bare field names and types only: no description, no dropdowns. The new Alerts button opens a reference page instead: per screen the exact action names (esphome.<node>_show_alert and _dismiss_alert) with copy buttons and whether the firmware is new enough, a paste-ready YAML example per screen, every field with explanation, example and the byte limits per board, all icons with glyph and name (searchable, tap copies), the colour swatches, the behaviour (timeout, button, flash, standby, replace), and the esphome.screen_alert event with an automation that waits for the button. core.alert_reference() carries the data and tests/test_alerts_reference.py keeps it equal to what both board profiles, tile_palette.h, alert_overlay.h and tile_icons.py compile. Screens carry alert_action and dismiss_action in the inventory. App only; firmware stays 0.2.31. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
468 lines
20 KiB
HTML
468 lines
20 KiB
HTML
<!doctype html>
|
||
<html lang="nl">
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
||
<title>ESP Screens</title>
|
||
<link rel="stylesheet" href="static/style.css" />
|
||
<script src="static/app.js" defer></script>
|
||
</head>
|
||
<body>
|
||
<header>
|
||
<div class="brand">
|
||
<span class="mark">▦</span>
|
||
<div>
|
||
<strong>ESP Screens</strong
|
||
><small>Tegels voor je CYD en Guition, zonder opnieuw flashen</small>
|
||
</div>
|
||
</div>
|
||
<nav class="toolbar" aria-label="Acties">
|
||
<button id="new-screen" class="tool tool-primary">
|
||
<span class="tool-icon" aria-hidden="true">＋</span>
|
||
<span class="tool-text"
|
||
><b>Nieuw scherm</b><small>Aansluiten en installeren</small></span
|
||
>
|
||
</button>
|
||
<button id="open-firmware" class="tool">
|
||
<span class="tool-icon" aria-hidden="true">⇪</span>
|
||
<span class="tool-text"
|
||
><b>Firmware & USB</b
|
||
><small>Bouwen en installeren via USB of wifi</small></span
|
||
>
|
||
</button>
|
||
<button id="open-alerts" class="tool">
|
||
<span class="tool-icon" aria-hidden="true">!</span>
|
||
<span class="tool-text"
|
||
><b>Alerts</b
|
||
><small>Meldingen over het hele scherm, vanuit een automatisering</small></span
|
||
>
|
||
</button>
|
||
</nav>
|
||
</header>
|
||
<main>
|
||
<div class="intro">
|
||
<div>
|
||
<p class="eyebrow">HOME ASSISTANT</p>
|
||
<h1>Beheer je remote screens hier.</h1>
|
||
</div>
|
||
<span id="connection" role="status" class="badge">Verbinden…</span>
|
||
</div>
|
||
<div class="workspace">
|
||
<aside>
|
||
<h2>Mijn schermen</h2>
|
||
<div id="screens"></div>
|
||
<div id="pending"></div>
|
||
<button class="quiet" id="refresh">↻ Vernieuwen</button>
|
||
<div class="updates" id="updates" hidden>
|
||
<h2>Firmware-updates</h2>
|
||
<p class="hint" id="updates-hint"></p>
|
||
<button id="update-all" hidden>Alle schermen bijwerken</button>
|
||
<label class="check">
|
||
<input type="checkbox" id="auto-update" />
|
||
<span
|
||
>Elke nacht automatisch bijwerken<small
|
||
>Tussen 03:00 en 06:00, één scherm tegelijk. Stopt bij een
|
||
fout en meldt dat in Home Assistant.</small
|
||
></span
|
||
>
|
||
</label>
|
||
</div>
|
||
</aside>
|
||
<section id="empty" class="empty">
|
||
<span class="empty-icon">▦</span>
|
||
<h2>Begin met een scherm</h2>
|
||
<p>
|
||
Sluit een CYD of Guition via USB aan op je Home Assistant-machine.
|
||
Profiel, firmware en de eerste flash gebeuren in één venster.
|
||
</p>
|
||
<button id="start">Nieuw scherm installeren</button>
|
||
</section>
|
||
<section id="editor" hidden>
|
||
<div class="editor-head">
|
||
<div>
|
||
<p class="eyebrow" id="screen-name"></p>
|
||
<h2>Maak het jouw scherm</h2>
|
||
</div>
|
||
<span id="delivery" class="badge"></span>
|
||
</div>
|
||
<label
|
||
>Naam bovenaan het scherm<input
|
||
id="title"
|
||
maxlength="60"
|
||
placeholder="Bijvoorbeeld: Woonkamer"
|
||
/></label>
|
||
<nav class="editor-nav" aria-label="Scherm beheren">
|
||
<button id="nav-tiles" class="quiet">Tegels instellen</button>
|
||
<button id="nav-settings" class="quiet">
|
||
Algemene instellingen
|
||
</button>
|
||
<button id="nav-inspector" class="quiet">Inspector</button>
|
||
</nav>
|
||
<div class="columns" id="tile-section">
|
||
<div class="tile-editor">
|
||
<div class="section-title">
|
||
<h3>Je tegels</h3>
|
||
<span id="count">0 / 10</span>
|
||
</div>
|
||
<div id="layout-preview" aria-label="Schermindeling"></div>
|
||
<button id="add-page" class="quiet add-page" type="button">
|
||
＋ Pagina toevoegen
|
||
</button>
|
||
<p id="no-tiles" class="hint">
|
||
Voeg je eerste lamp, scène of apparaat toe via de kiezer.
|
||
</p>
|
||
<p id="positions-hint" class="hint" hidden></p>
|
||
</div>
|
||
<div class="picker">
|
||
<label for="search">Voeg een entiteit toe</label
|
||
><input
|
||
id="search"
|
||
type="search"
|
||
placeholder="Zoek op naam, apparaat of ruimte…"
|
||
autocomplete="off"
|
||
/>
|
||
<div class="filters" id="filters"></div>
|
||
<div id="results" aria-live="polite"></div>
|
||
</div>
|
||
</div>
|
||
<details class="screen-settings" id="general-settings" open>
|
||
<summary>
|
||
Scherminstellingen
|
||
<span class="hint">Helderheid, rustmomenten en weergave</span>
|
||
</summary>
|
||
<p class="hint" id="settings-support"></p>
|
||
<div class="settings-grid" id="settings-fields"></div>
|
||
<p class="hint">
|
||
Nachturen gelden voor de helderheid tijdens standby. De eerste
|
||
aanraking maakt het scherm wakker; de volgende bedient je huis.
|
||
Gelijke begin- en eindtijd schakelen het nachtvenster uit.
|
||
</p>
|
||
</details>
|
||
<details class="screen-settings" id="inspector-section">
|
||
<summary>
|
||
Inspector
|
||
<span class="hint"
|
||
>Verbinding, status en ondersteunde eigenschappen</span
|
||
>
|
||
</summary>
|
||
<button id="inspect" class="quiet">Lees actuele gegevens</button>
|
||
<div id="inspection-summary"></div>
|
||
<pre id="inspection">Selecteer een scherm en lees de gegevens.</pre>
|
||
</details>
|
||
<footer class="savebar">
|
||
<div>
|
||
<strong id="dirty">Alles opgeslagen</strong
|
||
><small id="save-detail"
|
||
>Aanpassen kan zonder opnieuw flashen.</small
|
||
>
|
||
</div>
|
||
<button id="save">Opslaan & naar scherm</button>
|
||
</footer>
|
||
</section>
|
||
</div>
|
||
</main>
|
||
<dialog id="installer">
|
||
<form id="install-form">
|
||
<div class="dialog-head">
|
||
<div>
|
||
<p class="eyebrow">NIEUW SCHERM</p>
|
||
<h2 id="install-title">Aansluiten en installeren.</h2>
|
||
</div>
|
||
<button
|
||
type="button"
|
||
class="quiet"
|
||
id="close-install"
|
||
aria-label="Sluiten"
|
||
>
|
||
✕
|
||
</button>
|
||
</div>
|
||
<div id="install-setup">
|
||
<p>
|
||
Sluit het scherm met een USB-datakabel aan op de machine waarop Home
|
||
Assistant draait. ESP Screens maakt een eigen profiel met unieke
|
||
sleutels, bouwt de firmware en zet die direct op het scherm.
|
||
</p>
|
||
<fieldset>
|
||
<legend>Welk scherm heb je?</legend>
|
||
<label class="board"
|
||
><input type="radio" name="board" value="cyd" checked /><span
|
||
><b>CYD · 2,8 inch</b
|
||
><small>ESP32-2432S028 · 320 × 240</small></span
|
||
></label
|
||
><label class="board"
|
||
><input type="radio" name="board" value="guition" /><span
|
||
><b>Guition · 4 inch</b
|
||
><small>ESP32-S3-4848S040 · 480 × 480 · GT911</small></span
|
||
></label
|
||
>
|
||
</fieldset>
|
||
<label
|
||
>Naam<input
|
||
name="friendly_name"
|
||
required
|
||
maxlength="60"
|
||
placeholder="Scherm woonkamer"
|
||
autocomplete="off" /><small class="node-line"
|
||
>Apparaatnaam <code id="node-preview">scherm</code
|
||
><button type="button" class="link" id="edit-node">
|
||
aanpassen
|
||
</button></small
|
||
><small
|
||
>Elk scherm krijgt een eigen profiel met eigen sleutels. Vier
|
||
schermen? Doorloop dit vier keer met een andere naam.</small
|
||
></label
|
||
>
|
||
<label id="node-label" hidden
|
||
>Apparaatnaam<input
|
||
name="name"
|
||
pattern="[a-z][a-z0-9-]{0,29}"
|
||
maxlength="30"
|
||
autocomplete="off" /><small
|
||
>Kleine letters, cijfers en streepjes. Elk scherm een andere
|
||
naam.</small
|
||
></label
|
||
>
|
||
<fieldset id="wifi-fields" class="wifi" hidden disabled>
|
||
<legend>Wifi</legend>
|
||
<p class="hint" id="wifi-status"></p>
|
||
<label id="wifi-ssid-label"
|
||
>Wifi-naam (2,4 GHz)<input name="wifi_ssid" autocomplete="off"
|
||
/></label>
|
||
<label id="wifi-password-label"
|
||
>Wifiwachtwoord<input
|
||
name="wifi_password"
|
||
type="password"
|
||
autocomplete="new-password"
|
||
/></label>
|
||
</fieldset>
|
||
<label
|
||
>Installeren via<select name="target" id="install-target"></select
|
||
><small id="target-hint"></small
|
||
></label>
|
||
<p class="hint" id="install-note"></p>
|
||
<div class="install-actions">
|
||
<button type="submit" id="install-go">Installeren</button>
|
||
<span id="install-status" role="status"></span>
|
||
</div>
|
||
</div>
|
||
<div id="install-progress" hidden>
|
||
<div class="progress-head">
|
||
<span class="spin" id="progress-spin"></span>
|
||
<span class="outcome" id="progress-mark" hidden></span>
|
||
<strong id="progress-title"></strong>
|
||
</div>
|
||
<p id="progress-detail"></p>
|
||
<div id="install-result" hidden>
|
||
<div class="key-box">
|
||
<span>API-sleutel</span><code id="api-key"></code>
|
||
<button type="button" class="mini" id="copy-key">Kopieer</button>
|
||
</div>
|
||
<ol class="steps" id="install-steps"></ol>
|
||
</div>
|
||
<details id="install-log-wrap">
|
||
<summary>Log van ESPHome</summary>
|
||
<pre id="install-log"></pre>
|
||
</details>
|
||
<div class="install-actions">
|
||
<button type="button" id="install-retry" hidden>
|
||
Opnieuw proberen
|
||
</button>
|
||
<button type="button" class="quiet" id="install-close">
|
||
Sluiten
|
||
</button>
|
||
</div>
|
||
</div>
|
||
</form>
|
||
</dialog>
|
||
<dialog id="firmware-dialog">
|
||
<div class="dialog-head">
|
||
<div>
|
||
<p class="eyebrow">FIRMWARE & USB</p>
|
||
<h2>Schermfirmware bouwen en installeren</h2>
|
||
</div>
|
||
<button id="close-firmware" class="quiet" aria-label="Sluiten">✕</button>
|
||
</div>
|
||
<p>
|
||
De ingebouwde ESPHome CLI gebruikt je eigen profiel (YAML met sleutels)
|
||
en secrets. Kies het profiel van het scherm, dan een USB-poort (scherm
|
||
aan de Home Assistant-machine) of <b>Wifi / OTA</b> met de hostnaam.
|
||
<b>Controleren</b> valideert alleen, <b>Alleen bouwen</b> compileert,
|
||
<b>Bouwen & installeren</b> zet de firmware op het scherm. Je tegels
|
||
blijven in ESP Screens staan. De eerste build duurt enkele minuten.
|
||
</p>
|
||
<label>ESPHome-profiel<select id="firmware-file"></select></label>
|
||
<label
|
||
>Installeren naar<select id="firmware-port">
|
||
<option value="ota">Wifi / OTA</option>
|
||
</select></label
|
||
>
|
||
<label id="firmware-host-label"
|
||
>IP-adres of hostnaam<input
|
||
id="firmware-host"
|
||
placeholder="scherm-woonkamer.local"
|
||
/></label>
|
||
<div class="yaml-actions">
|
||
<button id="firmware-validate" class="quiet">Controleren</button
|
||
><button id="firmware-build" class="quiet">Alleen bouwen</button
|
||
><button id="firmware-install">Bouwen & installeren</button>
|
||
</div>
|
||
<p id="firmware-status" role="status"></p>
|
||
<pre id="firmware-log"></pre>
|
||
</dialog>
|
||
<dialog id="tile-sheet" class="tile-sheet" aria-label="Tegel instellen"></dialog>
|
||
<dialog id="alerts-dialog" class="alerts" aria-label="Alerts">
|
||
<div class="dialog-head">
|
||
<div>
|
||
<p class="eyebrow">ALERTS · CHEATSHEET</p>
|
||
<h2>Een melding over het hele scherm, vanuit een automatisering.</h2>
|
||
</div>
|
||
<button id="close-alerts" class="quiet" aria-label="Sluiten">✕</button>
|
||
</div>
|
||
<p>
|
||
Elk scherm heeft de actie <code>show_alert</code>. Die legt een kaart over alles
|
||
heen, wekt het scherm en houdt de backlight op de normale helderheid tot iemand op
|
||
de knop tikt of de timeout verstrijkt. Home Assistant toont bij ESPHome-acties
|
||
zelf geen uitleg of keuzelijsten; alles wat je kunt invullen staat hier.
|
||
</p>
|
||
<div class="alert-hero">
|
||
<div class="alert-mock" id="alert-mock" aria-hidden="true">
|
||
<div class="alert-mock-card">
|
||
<span class="mdi alert-mock-icon" id="alert-mock-icon"></span>
|
||
<strong id="alert-mock-title">Iemand belt aan</strong>
|
||
<span id="alert-mock-subtitle">Deur 3, achterkant</span>
|
||
<button type="button" id="alert-mock-button" tabindex="-1">Ik kom</button>
|
||
</div>
|
||
</div>
|
||
<nav class="alerts-nav" aria-label="Onderdelen">
|
||
<button type="button" data-jump="alerts-screens">Jouw schermen</button>
|
||
<button type="button" data-jump="alerts-howto">In een automatisering</button>
|
||
<button type="button" data-jump="alerts-fields">De velden</button>
|
||
<button type="button" data-jump="alerts-icons">Iconen</button>
|
||
<button type="button" data-jump="alerts-colors">Kleuren</button>
|
||
<button type="button" data-jump="alerts-behaviour">Gedrag</button>
|
||
<button type="button" data-jump="alerts-events">Events</button>
|
||
<button type="button" data-jump="alerts-tips">Tips</button>
|
||
</nav>
|
||
</div>
|
||
<section id="alerts-screens">
|
||
<h3>Jouw schermen</h3>
|
||
<p>
|
||
Elke scherm heeft zijn eigen actie, met de apparaatnaam erin. Vanaf firmware
|
||
<code id="alerts-min-firmware">0.2.31</code>; een ouder scherm werk je bij onder
|
||
Firmware-updates.
|
||
</p>
|
||
<div id="alerts-screen-list"></div>
|
||
</section>
|
||
<section id="alerts-howto">
|
||
<h3>In een automatisering</h3>
|
||
<ol class="steps">
|
||
<li><b>Actie toevoegen</b> en zoek op <b>ESPHome</b>. Kies de actie van je scherm:
|
||
Home Assistant noemt hem "Performs the action show_alert of the node
|
||
<i>apparaatnaam</i>".</li>
|
||
<li><b>Vul de velden in.</b> Home Assistant vraagt alle zeven; laat wat je niet
|
||
gebruikt leeg (<code>""</code>, <code>0</code>, uit).</li>
|
||
<li>Liever YAML? Kies <b>Bewerken in YAML</b> bij de actie en plak het voorbeeld
|
||
hieronder.</li>
|
||
</ol>
|
||
<div class="alert-example">
|
||
<label
|
||
>Voorbeeld voor<select id="alerts-example-screen"></select
|
||
></label>
|
||
<div class="copy-line">
|
||
<pre id="alerts-example"></pre>
|
||
<button type="button" class="mini" id="alerts-example-copy">Kopieer YAML</button>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
<section id="alerts-fields">
|
||
<h3>De velden</h3>
|
||
<p>
|
||
Teksten zijn vrij; de limiet is in bytes en een letter met accent telt voor twee.
|
||
Wat niet past krijgt puntjes (titel) of valt weg (subtitle).
|
||
</p>
|
||
<div class="table-scroll"><table id="alerts-field-table"></table></div>
|
||
</section>
|
||
<section id="alerts-icons">
|
||
<h3>Iconen</h3>
|
||
<p>
|
||
Vul de naam in bij <code>icon</code>, bijvoorbeeld <code>doorbell</code>.
|
||
<code>mdi:doorbell</code> en de hex-codepoint (<code>F12E6</code>) mogen ook.
|
||
Alleen deze iconen zitten in de firmware; een andere naam geeft de
|
||
waarschuwingsdriehoek. Tik op een icoon om de naam te kopiëren.
|
||
</p>
|
||
<p class="alerts-subhead">Handig voor meldingen</p>
|
||
<div class="chips" id="alerts-suggested"></div>
|
||
<label class="alerts-search"
|
||
>Zoek een icoon<input
|
||
id="alerts-icon-search"
|
||
type="search"
|
||
placeholder="Zoek op naam of omschrijving…"
|
||
autocomplete="off"
|
||
/></label>
|
||
<div id="alerts-icon-groups"></div>
|
||
</section>
|
||
<section id="alerts-colors">
|
||
<h3>Kleuren</h3>
|
||
<p>
|
||
Vul de naam in bij <code>color</code>. Dit zijn de pasteltinten van de tegels,
|
||
met donkere tekst. Leeg of onbekend geeft de witte kaart. Tik om te kopiëren.
|
||
</p>
|
||
<div class="swatches" id="alerts-swatches"></div>
|
||
</section>
|
||
<section id="alerts-behaviour">
|
||
<h3>Gedrag</h3>
|
||
<ul class="alerts-list">
|
||
<li><b>Wekken.</b> Een alert maakt een gedimd of donker scherm meteen wakker en
|
||
komt boven elke pagina, elke open lichtkaart en de standby-laag.</li>
|
||
<li><b>Aan tot de knop.</b> Zolang de kaart staat blijft de backlight op de
|
||
normale helderheid. Standby en de nachturen wachten. Na de knop start de gewone
|
||
standby-tijd opnieuw.</li>
|
||
<li><b>Timeout.</b> <code>timeout: 0</code> wacht op de knop, hoe lang ook. Met
|
||
<code>timeout: 60</code> verdwijnt de kaart na een minuut, maar de knop sluit
|
||
hem eerder.</li>
|
||
<li><b>Knipperen.</b> <code>flash: true</code> knippert de backlight vier keer
|
||
bij binnenkomst (ongeveer een seconde) en laat het scherm daarna aan.</li>
|
||
<li><b>Vervangen.</b> Een nieuwe alert vervangt de huidige; er is geen stapel.
|
||
De vervangen alert meldt zich als <code>replaced</code>.</li>
|
||
<li><b>Op afstand sluiten.</b> <code>dismiss_alert</code> haalt de kaart weg,
|
||
bijvoorbeeld als de deur al open is. Zonder alert doet die actie niets.</li>
|
||
<li><b>Tikken naast de kaart</b> doet niets; alleen de knop sluit. Zo drukt een
|
||
wek-tik de alert nooit per ongeluk weg.</li>
|
||
</ul>
|
||
</section>
|
||
<section id="alerts-events">
|
||
<h3>Events</h3>
|
||
<p>
|
||
Elk einde vuurt het event <code id="alerts-event-name">esphome.screen_alert</code>
|
||
met <code>action</code>, <code>title</code>, <code>screen</code> (de apparaatnaam)
|
||
en het <code>device_id</code> dat Home Assistant toevoegt. Te zien onder
|
||
Ontwikkelhulpmiddelen → Events.
|
||
</p>
|
||
<div class="table-scroll"><table id="alerts-ending-table"></table></div>
|
||
<p class="alerts-subhead">Wachten tot iemand op de knop drukt</p>
|
||
<div class="copy-line">
|
||
<pre id="alerts-wait-example"></pre>
|
||
<button type="button" class="mini" id="alerts-wait-copy">Kopieer YAML</button>
|
||
</div>
|
||
</section>
|
||
<section id="alerts-tips">
|
||
<h3>Tips</h3>
|
||
<ul class="alerts-list">
|
||
<li>Gebruik een <b>kleur per soort melding</b>: oranje voor de deur, rood voor
|
||
rook of water, groen voor "klaar". De tekst blijft altijd donker en leesbaar.</li>
|
||
<li>Houd de titel <b>kort</b>; de CYD toont ongeveer veertig tekens op één regel.
|
||
Zet details in de subtitle.</li>
|
||
<li>Een <b>eigen knoptekst</b> maakt de melding een vraag: "Ik kom", "Gezien",
|
||
"Uitzetten". Het event zegt dan wie reageerde.</li>
|
||
<li>Een alert die zichzelf oplost (de deur gaat open, de was is eruit gehaald)
|
||
sluit je in dezelfde automatisering met <code>dismiss_alert</code>.</li>
|
||
<li>Meerdere schermen? Roep de actie van elk scherm aan; ze werken los van
|
||
elkaar en melden zich elk met hun eigen <code>screen</code>.</li>
|
||
</ul>
|
||
</section>
|
||
</dialog>
|
||
<div id="toast" role="status" hidden></div>
|
||
</body>
|
||
</html>
|