From f13d8ad0edf8c6288515c587f25b6bb13cd34433 Mon Sep 17 00:00:00 2001 From: Max Gramser Date: Fri, 18 Sep 2026 13:23:33 +0200 Subject: [PATCH] A media card like a phone's now playing, with the album cover on a Guition (0.2.77) The card behind a media tile shows the album cover, the title, the artist and the album, a progress bar that runs while the track plays with the times at its ends, round keys for previous, play or pause and next, and a volume row with a mute key, a wide slider and the percentage. Keys the player lacks stay faded, an off player shows one power key, a stream without a length shows no bar, and the CYD shows the player's icon in the cover's place. A media tile over the whole page is the same card under the tile's head. media_card.h holds the geometry, tests/test_media_card.cpp checks every shape. The cover comes the way camera images do: the screen asks with the size and the colour behind the corners, the app fetches the picture from Home Assistant, cuts it square, rounds the corners over that colour and serves it on port 8098; the Guition loads it once and asks again only when the picture's mark in the state changes. Firmware 0.2.64. Co-Authored-By: Claude Fable 5.1 --- README.md | 14 +- components/smart_display/camera_view.h | 15 +- components/smart_display/media_card.h | 156 +++++++ components/smart_display/runtime_model.h | 8 +- components/smart_display/runtime_tiles.h | 494 ++++++++++++++++++++--- components/smart_display/theme.h | 3 + components/smart_display/tile_controls.h | 2 +- docs/CAMERA.md | 17 + docs/TEST_RESULTS_0277.md | 85 ++++ docs/images/cyd-dark-media.png | Bin 0 -> 11789 bytes docs/images/cyd-media-full.png | Bin 0 -> 13483 bytes docs/images/cyd-media.png | Bin 0 -> 11725 bytes docs/images/guition-dark-media.png | Bin 0 -> 27846 bytes docs/images/guition-media-full.png | Bin 0 -> 37824 bytes docs/images/guition-media.png | Bin 0 -> 27604 bytes guition-4848s040.yaml | 2 +- home-like-2432s028.yaml | 2 +- packages/cyd.yaml | 2 +- packages/guition.yaml | 2 +- screen_manager/CHANGELOG.md | 11 + screen_manager/app/camera_feed.py | 142 ++++++- screen_manager/app/core.py | 36 +- screen_manager/app/server.py | 57 ++- screen_manager/config.yaml | 2 +- tests/test_camera_view.cpp | 34 ++ tests/test_media_card.cpp | 103 +++++ tests/test_media_card.py | 268 ++++++++++++ 27 files changed, 1381 insertions(+), 74 deletions(-) create mode 100644 components/smart_display/media_card.h create mode 100644 docs/TEST_RESULTS_0277.md create mode 100644 docs/images/cyd-dark-media.png create mode 100644 docs/images/cyd-media-full.png create mode 100644 docs/images/cyd-media.png create mode 100644 docs/images/guition-dark-media.png create mode 100644 docs/images/guition-media-full.png create mode 100644 docs/images/guition-media.png create mode 100644 tests/test_media_card.cpp create mode 100644 tests/test_media_card.py diff --git a/README.md b/README.md index e1b756f..e12f638 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,12 @@ also be changed on the screen or by an automation, and your own YAML for one scr Cover card for a venetian blind: its battery, the position slider with the blind hanging from the top, the tilt slider over slats, and open, stop and close A finger on the history graph: the top of the card shows the average of that hour and its time, the graph stays as it is

-

Tap a tile to switch it, hold it for the full card. Keys and sliders right on the tile, pastel colors, a clock, the weather and history you can read with a finger. Rendered from the firmware's own LVGL code with a demo home.

+

+ The media card on the Guition: the album cover, the title, artist and album, a progress bar with the elapsed and total time, previous, pause and next keys and the volume slider + A media player over the whole page: the cover at the left, the track, the bar and the keys beside it, the volume row along the bottom + The media card in dark mode: the same cover and keys on a black page +

+

Tap a tile to switch it, hold it for the full card. Keys and sliders right on the tile, pastel colors, a clock, the weather and history you can read with a finger. The media card shows what plays with its album cover, fetched by ESP Screens like a camera picture (how). Rendered from the firmware's own LVGL code with a demo home.

CYD 2.8-inch screen: the weather forecast, a kitchen timer, the coffee machine, a lamp and power usage as a large value Second CYD page: Sonos volume, presence, a scene and an energy graph @@ -62,7 +67,12 @@ also be changed on the screen or by an automation, and your own YAML for one scr The vacuum card on the CYD: state, battery and charging, clean and dock, the cleaning mode, suction and water The history card on the CYD: power over 24 hours with its highest and lowest moment, an axis in watts and clock times

-

The same cards on the 2.8-inch CYD, 320 × 240.

+

+ The media card on the CYD: the player's icon where the cover would be, the title, artist and album, the bar with its times, the keys and the volume slider + A media player over the whole CYD page: the icon at the left, the track and the keys beside it, the volume row along the bottom + The media card on the CYD in dark mode +

+

The same cards on the 2.8-inch CYD, 320 × 240. The CYD has no memory for pictures: its media card shows the player's icon in the cover's place.

Dark mode on the Guition: the same home page with a black page, graphite cards and soft white text, the clock, the temperature graph, the weather, a lamp and presence Dark mode with direct control: the heating setpoint, the dimmer's slider and the Sonos volume keep their colours diff --git a/components/smart_display/camera_view.h b/components/smart_display/camera_view.h index 0f76390..0dfe7ca 100644 --- a/components/smart_display/camera_view.h +++ b/components/smart_display/camera_view.h @@ -21,11 +21,18 @@ struct Feed { std::string entity, url; uint32_t asked_at = 0, started_at = 0, finished_at = 0; bool asked = false, loading = false, shown = false, empty = false; // empty: the app said it has no image + // once (firmware 0.2.64+): an album cover on the media card. It loads one time per link and stays; a new cover comes + // with a new link (the card asks again when Home Assistant's picture changes), never on a clock. + bool once = false, loaded = false; // loaded: this link's image is on screen uint8_t failures = 0; - void open(const std::string &camera) { *this = Feed{}; entity = camera; } + void open(const std::string &camera, bool one_load = false) { *this = Feed{}; entity = camera; once = one_load; } bool open() const { return !entity.empty(); } - bool should_ask(uint32_t now) const { return open() && !loading && url.empty() && (!asked || now - asked_at >= ASK_AGAIN_MS); } + // A cover the app has none of (or an app that knows no covers) is asked for once: the card keeps its placeholder. + bool should_ask(uint32_t now) const { + if (once && empty) return false; + return open() && !loading && url.empty() && (!asked || now - asked_at >= ASK_AGAIN_MS); + } void ask(uint32_t now) { asked = true; asked_at = now; } // The app's answer: a link, or none (no image from Home Assistant, or a camera this screen may not show). void link(const std::string &address) { @@ -33,17 +40,19 @@ struct Feed { empty = address.empty(); failures = 0; started_at = finished_at = 0; + loaded = false; } bool should_load(uint32_t now) const { if (!open() || loading || url.empty()) return false; if (!started_at) return true; + if (once) return !loaded && now - finished_at >= GAP_MS; // a failed load is tried again, a loaded one stays return now - started_at >= REFRESH_MS && now - finished_at >= GAP_MS; } void start(uint32_t now) { loading = true; started_at = now ? now : 1; } void finish(uint32_t now, bool ok) { loading = false; finished_at = now; - if (ok) { shown = true; failures = 0; return; } + if (ok) { shown = true; loaded = true; failures = 0; return; } if (++failures >= MAX_FAILURES) { url.clear(); asked = false; failures = 0; } } }; diff --git a/components/smart_display/media_card.h b/components/smart_display/media_card.h new file mode 100644 index 0000000..1ae72e2 --- /dev/null +++ b/components/smart_display/media_card.h @@ -0,0 +1,156 @@ +#pragma once +// The media card (firmware 0.2.64+): where its parts go and what its texts say. Pure arithmetic, free of LVGL and +// ESPHome, so tests/test_media_card.cpp checks every shape on a PC; runtime_tiles.h draws it. +// +// The card is a "now playing" view like a phone's: the album art (or a placeholder with the player's icon), the title, +// the artist and the album, a progress bar with the elapsed and total time, three round keys (previous, play or pause, +// next) and a volume row (a mute key, a slider, the percentage). Two forms share one recipe: a tall area (the Guition's +// card, 480 wide under its top bar) stacks everything under the art; a wide area (the CYD's card, a tile over the whole +// page) puts the art at the left with the texts, the bar and the keys beside it. The volume row always runs along the +// bottom. What does not fit goes: first the artist line, then the times beside the bar, and the art shrinks last. +#include +#include +#include +#include + +namespace media_card { +struct Rect { + int x = 0, y = 0, w = 0, h = 0; + int cx() const { return x + w / 2; } + int cy() const { return y + h / 2; } + int right() const { return x + w; } + int bottom() const { return y + h; } +}; +// What the board brings: its size class and the line heights of the fonts the card writes with. +struct Metrics { + bool large = true; // the Guition: big keys and a big cover; the CYD gets the small numbers + int title_h = 32; // the title's font (the card heading font) + int artist_h = 25; // the artist line (the control font) + int small_h = 19; // the times and the percentage (the small font) + int key_h() const { return large ? 52 : 34; } // previous and next + int play_h() const { return large ? 64 : 40; } // play or pause, the biggest key: a thumb finds it without looking + int key_gap() const { return large ? 28 : 14; } // between the keys, less when the row has no room + int min_gap() const { return large ? 12 : 8; } + int mute_h() const { return large ? 32 : 22; } + int slider_h() const { return large ? 20 : 12; } + int bar_h() const { return large ? 6 : 4; } + int gap() const { return large ? 12 : 6; } + int margin() const { return large ? 24 : 10; } + int max_art() const { return large ? 200 : 120; } + int percent_w() const { return large ? 52 : 34; } + int time_w() const { return large ? 48 : 34; } // "12:34" beside the bar +}; +struct Layout { + bool wide = false; // the art at the left, everything else beside it + bool times = false; // the elapsed and total time at the ends of the bar + bool artist = true; // the artist line (a tile over a CYD page has no room for it) + Rect art, title, artist_line, bar, elapsed, total, prev, play, next, mute, volume, percent; + int art_radius = 0; // the corner the art is rounded with (baked into the picture by the app) +}; + +inline int radius_for(int art) { return std::max(4, art / 12); } + +// The card's parts inside an area of `width` × `height` whose top left is (0, 0): the room under the top bar of a +// card, or under the head of a tile over the whole page. +inline Layout layout(const Metrics &m, int width, int height) { + Layout l; + const int g = m.gap(), margin = m.margin(); + // The volume row along the bottom, whatever the form. + const int volume_h = std::max(m.mute_h(), m.slider_h()); + l.mute = {margin, height - volume_h + (volume_h - m.mute_h()) / 2, m.mute_h(), m.mute_h()}; + l.percent = {width - margin - m.percent_w(), height - volume_h + (volume_h - m.small_h) / 2, m.percent_w(), m.small_h}; + const int slider_x = l.mute.right() + g; + l.volume = {slider_x, height - volume_h + (volume_h - m.slider_h()) / 2, std::max(1, l.percent.x - g - slider_x), m.slider_h()}; + const int above = height - volume_h - g; // room for the rest + l.wide = width * 4 > height * 5; + const int row_min = 2 * m.key_h() + m.play_h() + 2 * m.min_gap(); + // The bar's row: the elapsed time at the left, the total at the right, the bar between them, on one small line. + auto bar_row = [&](int x, int w, int y, bool with_times) { + const int tw = with_times && w >= 4 * m.time_w() ? m.time_w() : 0; // no room for times on a very narrow row + l.times = tw > 0; + const int row_h = l.times ? m.small_h : m.bar_h(); + l.elapsed = {x, y, tw, m.small_h}; + l.total = {x + w - tw, y, tw, m.small_h}; + const int bar_x = x + (tw ? tw + g / 2 : 0), bar_w = std::max(1, w - 2 * (tw ? tw + g / 2 : 0)); + l.bar = {bar_x, y + (row_h - m.bar_h()) / 2, bar_w, m.bar_h()}; + return row_h; + }; + auto keys = [&](int x, int w, int y) { + const int gap = std::clamp((w - 2 * m.key_h() - m.play_h()) / 2, m.min_gap(), m.key_gap()); + const int row_w = 2 * m.key_h() + m.play_h() + 2 * gap, row_x = x + (w - row_w) / 2; + l.prev = {row_x, y + (m.play_h() - m.key_h()) / 2, m.key_h(), m.key_h()}; + l.play = {row_x + m.key_h() + gap, y, m.play_h(), m.play_h()}; + l.next = {l.play.right() + gap, l.prev.y, m.key_h(), m.key_h()}; + }; + if (!l.wide) { + // Tall: the art on top, the texts, the bar and the keys under it, all centred. + const int keys_y = above - m.play_h(); + const int stack = m.title_h + m.artist_h + g + m.small_h + g; // between the art and the keys: the bar row is one small line + int art = std::min(m.max_art(), keys_y - g - stack - g); + art = std::max(32, art); + const int stack_y = keys_y - g - stack, text_w = width - 2 * margin; + l.art = {(width - art) / 2, std::max(0, (stack_y - g - art) / 2), art, art}; + l.title = {margin, stack_y, text_w, m.title_h}; + l.artist_line = {margin, l.title.bottom(), text_w, m.artist_h}; + bar_row(margin, text_w, l.artist_line.bottom() + g, true); + keys(0, width, keys_y); + } else { + // Wide: the art at the left, a column beside it, centred on the art and never taller than the room; the column's + // own gaps are half the card's, so a tile's head leaves room for the artist line. + int art = std::min({m.max_art(), above, width - 2 * margin - 2 * g - row_min}); + art = std::max(32, art); + const int h = g / 2; + int column = m.title_h + m.artist_h + h + m.small_h + h + m.play_h(); + l.artist = column <= above; + if (!l.artist) column -= m.artist_h; + bool with_times = column <= above; + if (!with_times) column -= m.small_h - m.bar_h(); + l.art = {margin, std::max(0, (above - art) / 2), art, art}; + const int x = l.art.right() + 2 * g, w = std::max(1, width - margin - x); + int y = std::clamp(l.art.y + (art - column) / 2, 0, std::max(0, above - column)); + l.title = {x, y, w, m.title_h}; y += m.title_h; + if (l.artist) { l.artist_line = {x, y, w, m.artist_h}; y += m.artist_h; } + y += h; + y += bar_row(x, w, y, with_times); + keys(x, w, y + h); + } + l.art_radius = radius_for(l.art.w); + return l; +} + +// Home Assistant reports where the track was (media_position) and when it said so (media_position_updated_at); +// while playing the position runs on from that moment. +inline uint32_t elapsed_seconds(uint32_t position, uint32_t position_at, uint32_t now, bool playing, uint32_t duration) { + uint32_t elapsed = position; + if (playing && position_at && now > position_at) elapsed += now - position_at; + if (duration && elapsed > duration) elapsed = duration; + return elapsed; +} +// Per mille of the track, or -1 without a duration. +inline int progress(uint32_t position, uint32_t position_at, uint32_t now, bool playing, uint32_t duration) { + if (!duration) return -1; + return static_cast(elapsed_seconds(position, position_at, now, playing, duration) * 1000ULL / duration); +} +// "3:07", "1:02:45": the way every player writes a time. +inline std::string clock_text(uint32_t seconds) { + char b[24]; + if (seconds >= 3600) snprintf(b, sizeof(b), "%u:%02u:%02u", (unsigned) (seconds / 3600), (unsigned) (seconds / 60 % 60), (unsigned) (seconds % 60)); + else snprintf(b, sizeof(b), "%u:%02u", (unsigned) (seconds / 60), (unsigned) (seconds % 60)); + return b; +} +// The second line: "Artist · Album", or whichever of the two there is. +inline std::string subtitle(const std::string &artist, const std::string &album) { + if (!artist.empty() && !album.empty()) return artist + " · " + album; + return artist.empty() ? album : artist; +} +// What the card says instead of a title when nothing plays. +inline const char *idle_text(const std::string &state) { + if (state == "off") return "Off"; + if (state == "standby") return "Standby"; + if (state == "buffering") return "Loading"; + if (state == "unavailable") return "Unavailable"; + return "Not playing"; +} +inline bool playing(const std::string &state) { return state == "playing" || state == "buffering"; } +inline bool has_track(const std::string &state) { return state == "playing" || state == "paused" || state == "buffering"; } +} // namespace media_card diff --git a/components/smart_display/runtime_model.h b/components/smart_display/runtime_model.h index 0f475b7..808e0be 100644 --- a/components/smart_display/runtime_model.h +++ b/components/smart_display/runtime_model.h @@ -95,6 +95,11 @@ struct Extra { std::string sunrise, sunset, duration, remaining; uint32_t timer_end = 0; std::string media_title; + // The media card (firmware 0.2.64+, app 0.2.77+): the artist and the album, the track's length and where it was when + // Home Assistant last said so (seconds, and that moment as an epoch), and a short mark of the cover picture, empty + // when the player shows none. The mark changes with the picture: the card fetches a new cover when it does. + std::string media_artist, media_album, media_picture; + uint32_t media_duration = 0, media_position = 0, media_position_at = 0; // Vacuum: its own speeds (at most four) and speed, the mode, water and suction rows (see Choice), and // from sensors of its device the room it is in and whether it charges. std::vector fan_speeds; @@ -115,7 +120,8 @@ struct Extra { return hvac_modes.empty() && fan_modes.empty() && swing_modes.empty() && fan_mode.empty() && swing_mode.empty() && hvac_action.empty() && options.empty() && forecast.empty() && hours.empty() && std::isnan(wind) && std::isnan(feels) && wind_unit.empty() && sunrise.empty() && sunset.empty() && duration.empty() && - remaining.empty() && !timer_end && media_title.empty() && fan_speeds.empty() && fan_speed.empty() && + remaining.empty() && !timer_end && media_title.empty() && media_artist.empty() && media_album.empty() && + media_picture.empty() && !media_duration && !media_position && !media_position_at && fan_speeds.empty() && fan_speed.empty() && choices.empty() && room.empty() && !charging && std::isnan(tilt) && action.empty() && action_data.empty() && action_templates.empty() && state_word.empty(); } diff --git a/components/smart_display/runtime_tiles.h b/components/smart_display/runtime_tiles.h index 221d464..b19b6e3 100644 --- a/components/smart_display/runtime_tiles.h +++ b/components/smart_display/runtime_tiles.h @@ -12,6 +12,7 @@ #include "tile_controls.h" #include "history_view.h" #include "camera_view.h" +#include "media_card.h" #include "swipe_profile.h" #include "esphome/components/json/json_util.h" #include "esphome/components/api/api_server.h" @@ -66,6 +67,10 @@ inline bool awake() { return !screen_awake || screen_awake(); } inline uint32_t now_epoch() { if (!now_time) return 0; auto t = now_time(); return t.is_valid() ? static_cast(t.timestamp) : 0; } inline void tick(); inline void refresh_tile(size_t index); +// Style setters that only touch a property when it changes (defined with the card renderers below). +inline void set_color(lv_obj_t *obj, lv_style_prop_t prop, lv_color_t color, lv_style_selector_t selector = 0); +inline void set_number(lv_obj_t *obj, lv_style_prop_t prop, int32_t number, lv_style_selector_t selector = 0); +inline void set_font(lv_obj_t *obj, const lv_font_t *value); #ifdef SWIPE_PROFILE inline void swipe_test(unsigned count, unsigned interval_ms, unsigned back_ms, JsonObject tuning); #endif @@ -81,6 +86,15 @@ inline void history_received(); inline void camera_open(const std::string &entity, const std::string &name); inline void camera_answer(const std::string &view, const std::string &entity, const std::string &url); inline bool camera_supported(); +// The media card's album cover (firmware 0.2.64+): the card or a tile over the whole page says which cover it shows, +// the board's online_image loads it; see the end of this file. +enum class CoverOwner : uint8_t { NONE, DETAIL, TILE }; +inline void cover_want(const std::string &entity, const std::string &picture, int size, uint32_t background, CoverOwner owner, size_t slot); +inline lv_image_dsc_t *cover_ready(const std::string &entity, int size, uint32_t background); +// The card's cover on screen, and the part a media tile keeps its cover in; both go with the image buffer. +inline lv_obj_t *media_detail_picture = nullptr; +constexpr unsigned MEDIA_PICTURE = 14; +inline void media_action(Tile &t, int cmd); inline uint32_t domain_accent(const Tile &t); inline const char *icon_for(const Tile &tile); inline void label(lv_obj_t *obj, const std::string &text); @@ -183,6 +197,9 @@ struct Widgets { lv_obj_t *extra{}; std::string extra_mode; bool extra_full=false; std::array parts{}; lv_point_precise_t *points{}; // Analog clock: centre and radius of the dial, so the second hand can move without a card redraw. int hand_cx=0, hand_cy=0, hand_r=0, hand_width=1; + // A media tile over the whole page (firmware 0.2.64+): the width of its progress bar, so the fill can run once a + // second without a card redraw. + int media_bar_w=0; // Soft area under a polyline (graph, sun path), painted by the extra container's draw event. const lv_point_precise_t *fill_points{}; unsigned fill_count=0; int fill_x=0, fill_y=0, fill_base=0; lv_color_t fill_color{}; lv_opa_t fill_opa=0; // Direct controls on a wide card: a panel at the right with pill keys, a -/+ pill, @@ -362,9 +379,10 @@ inline std::string receive(const std::string &payload) { } if (op == "camera") { // A link to a camera's image (app 0.2.66+): the answer to camera_request ("full"), or an alert's image ("alert", - // announced with an empty link before show_alert and sent again with the link). Only ESP Screens' own port. + // announced with an empty link before show_alert and sent again with the link), or the media card's cover + // ("cover", app 0.2.77+). Only ESP Screens' own port. const std::string view = string(root["t"], 8), entity = string(root["e"], 120), url = string(root["u"], 240); - if (!valid_entity(entity) || (view != "full" && view != "alert")) return false; + if (!valid_entity(entity) || (view != "full" && view != "alert" && view != "cover")) return false; if (!url.empty() && url.rfind("http://", 0) != 0) return false; camera_answer(view, entity, url); result = model.ready() ? "Synced" : "Loading tiles"; @@ -548,6 +566,12 @@ inline std::string receive(const std::string &payload) { tile.muted=a["is_volume_muted"].is() && a["is_volume_muted"].as(); tile.device_class=string(a["device_class"],24);next.hvac_action=string(a["hvac_action"],24); next.media_title=string(a["media_title"],80);tile.supported=a["supported_features"].as(); + // The media card (firmware 0.2.64+, app 0.2.77+): the artist, the album, the track's length and position, and a + // mark of the cover picture; an app from before sends none of them and the card shows what it has. + next.media_artist=string(extra["artist"],80);next.media_album=string(extra["album"],80);next.media_picture=string(extra["pic"],16); + next.media_duration=extra["dur"].is()?extra["dur"].as():0; + next.media_position=extra["pos"].is()?extra["pos"].as():0; + next.media_position_at=extra["at"].is()?extra["at"].as():0; tile.name = string(root["name"], 80); tile.state = string(root["state"], 160); tile.unit = string(a["unit_of_measurement"], 20); @@ -860,7 +884,8 @@ inline void slider_event(lv_event_t *e){ if(code==LV_EVENT_PRESS_LOST && captured_slider==slider){captured_slider=nullptr;slider_changed=false;} if(code==LV_EVENT_RELEASED && captured_slider==slider){ unsigned index=(uintptr_t)lv_event_get_user_data(e); - for(auto &w:widgets)if(w.slider==slider || w.control_slider==slider){index=w.index;break;} + // A slider among a card's own parts (the media tile's volume) belongs to the tile the slot shows now. + for(auto &w:widgets)if(w.slider==slider || w.control_slider==slider || (w.extra && lv_obj_get_parent(slider)==w.extra)){index=w.index;break;} bool changed=slider_changed;captured_slider=nullptr;slider_changed=false; if(changed && cyd::touch_guard.accept_slider(esphome::millis(),200+index))commit_slider(index,lv_slider_get_value(slider)); } @@ -876,37 +901,39 @@ inline void choose(Tile &t,Choice &row,const std::string &value){ row.sent=value;t.begin(esphome::millis()); lv_async_call([](void *){if(detail_root && !lv_obj_has_flag(detail_root,LV_OBJ_FLAG_HIDDEN))show_detail(detail_index);},nullptr); } +// What a key on a card does; `cmd` is the key's command. Shared by the plain keys (detail_button) and the round +// keys of the media card. -1 is Back. +inline void detail_command(int cmd){ + if(cmd==-1){hide_detail();return;} + // History ranges (firmware 0.2.51+): redraw after this event, which belongs to a key the redraw deletes. + if(cmd>=160&&cmd<163){ + static const uint32_t hours[]={1,24,168}; + if(detail_index=model.count || !allowed(esphome::millis(),300+cmd,"card button "+model.tiles[detail_index].entity))return; + auto &t=model.tiles[detail_index];if(!t.available()||t.waiting(esphome::millis()))return; + if(cmd<4){const char *services[]={"vacuum.start","vacuum.pause","vacuum.return_to_base","vacuum.locate"};action(services[cmd],t.entity);} + // Vacuum rows: 10-15 suction, 50-55 cleaning mode, 60-65 water. + static const std::pair rows[]={{10,'s'},{50,'m'},{60,'w'}}; + for(const auto &[first,kind]:rows) + if(cmd>=first && cmdvalues.size())choose(t,*row,row->values[cmd-first]);} + // The media card's keys (20-23); its volume slider goes through commit_slider. + if(cmd>=20 && cmd<=24)media_action(t,cmd); + if(cmd>=30 && cmd<38 && cmd-30<(int)t.extra().options.size())action(t.domain()+".select_option",t.entity,"option",t.extra().options[cmd-30]); + // Cover keys: 70 + tile_controls::Command (open, stop, close and the tilt keys). + if(cmd>=70 && cmd<130){auto a=tile_controls::key_action(t,cmd-70);if(a.valid()&&t.domain()=="cover")action(a.service,t.entity,a.key,a.value);} + if(cmd==40)action(t.state=="active"?"timer.pause":"timer.start",t.entity); + if(cmd==41)action("timer.cancel",t.entity); +} inline lv_obj_t *detail_button(const char *text,int x,int y,int width,int height,int command){ auto *button=lv_obj_create(detail_root);lv_obj_remove_style_all(button);lv_obj_set_pos(button,x,y);lv_obj_set_size(button,width,height); lv_obj_set_style_bg_color(button,theme::color(command==0?theme::ACCENT:theme::BUTTON),0);lv_obj_set_style_bg_opa(button,LV_OPA_COVER,0);lv_obj_set_style_radius(button,12,0);lv_obj_add_flag(button,LV_OBJ_FLAG_CLICKABLE); auto *label=detail_label(button,text,6,0,width-12);lv_obj_center(label);lv_obj_set_style_text_align(label,LV_TEXT_ALIGN_CENTER,0);if(command==0)lv_obj_set_style_text_color(label,theme::color(theme::ON_ACCENT),0);lv_obj_remove_flag(label,LV_OBJ_FLAG_CLICKABLE); - lv_obj_add_event_cb(button,[](lv_event_t *e){ - int cmd=(intptr_t)lv_event_get_user_data(e);if(cmd==-1){hide_detail();return;} - // History ranges (firmware 0.2.51+): redraw after this event, which belongs to a key the redraw deletes. - if(cmd>=160&&cmd<163){ - static const uint32_t hours[]={1,24,168}; - if(detail_index=model.count || !allowed(esphome::millis(),300+cmd,"card button "+model.tiles[detail_index].entity))return; - auto &t=model.tiles[detail_index];if(!t.available()||t.waiting(esphome::millis()))return; - if(cmd<4){const char *services[]={"vacuum.start","vacuum.pause","vacuum.return_to_base","vacuum.locate"};action(services[cmd],t.entity);} - // Vacuum rows: 10-15 suction, 50-55 cleaning mode, 60-65 water. - static const std::pair rows[]={{10,'s'},{50,'m'},{60,'w'}}; - for(const auto &[first,kind]:rows) - if(cmd>=first && cmdvalues.size())choose(t,*row,row->values[cmd-first]);} - if(cmd==20)action("media_player.media_play_pause",t.entity); - if(cmd==21)action("media_player.media_previous_track",t.entity); - if(cmd==22)action("media_player.media_next_track",t.entity); - if(cmd>=30 && cmd<38 && cmd-30<(int)t.extra().options.size())action(t.domain()+".select_option",t.entity,"option",t.extra().options[cmd-30]); - // Cover keys: 70 + tile_controls::Command (open, stop, close and the tilt keys). - if(cmd>=70 && cmd<130){auto a=tile_controls::key_action(t,cmd-70);if(a.valid()&&t.domain()=="cover")action(a.service,t.entity,a.key,a.value);} - if(cmd==40)action(t.state=="active"?"timer.pause":"timer.start",t.entity); - if(cmd==41)action("timer.cancel",t.entity); - },LV_EVENT_SHORT_CLICKED,(void*)(intptr_t)command); + lv_obj_add_event_cb(button,[](lv_event_t *e){detail_command((intptr_t)lv_event_get_user_data(e));},LV_EVENT_SHORT_CLICKED,(void*)(intptr_t)command); lv_obj_set_style_bg_color(button,theme::color(theme::ACCENT_PRESSED),LV_STATE_PRESSED); lv_obj_set_style_transform_width(button,-2,LV_STATE_PRESSED);lv_obj_set_style_transform_height(button,-2,LV_STATE_PRESSED); lv_obj_set_style_opa(button,LV_OPA_50,LV_STATE_DISABLED); @@ -1730,6 +1757,172 @@ inline void render_history_detail(const Tile &t,bool large,int width,int height, } history_ranges(pad,range_y,width-2*pad,range_h); } +// ---- The media card (firmware 0.2.64+) ---- +// "Now playing" as a phone shows it: the album cover (app 0.2.77+ serves it, a Guition draws it; the CYD keeps the +// placeholder), the title, the artist and the album, a progress bar that runs while the track plays, round keys for +// previous, play or pause and next, and the volume row. media_card.h decides where everything goes for a tall card and +// a wide one; the same parts draw the card here and a tile over the whole page (render_media_full). The keys go +// through detail_command like every card's, the slider through commit_slider. +inline lv_obj_t *media_progress_fill=nullptr,*media_elapsed_label=nullptr; // the card's, moved by tick() once a second +inline int media_bar_width=0; +inline media_card::Rect media_art_rect; // where the card's cover goes once it is here +inline uint32_t media_accent(){return theme::foreground(theme::ha::LIGHT_BLUE);} +inline const lv_font_t *tile_icon_font(){for(auto &w:widgets)if(w.icon_font)return w.icon_font;return mini_icon_font?mini_icon_font:detail_font;} +inline media_card::Metrics media_metrics(bool large){ + media_card::Metrics m;m.large=large; + const lv_font_t *title=watch_font?watch_font:detail_font,*artist=control_font?control_font:detail_font,*small=small_font?small_font:detail_font; + m.title_h=lv_font_get_line_height(title);m.artist_h=lv_font_get_line_height(artist);m.small_h=lv_font_get_line_height(small); + return m; +} +// What the keys do, on the card and on a tile over the whole page: 20 play or pause, 21 previous, 22 next, 23 mute. +inline void media_action(Tile &t,int cmd){ + if(cmd==20)action("media_player.media_play_pause",t.entity); + if(cmd==21)action("media_player.media_previous_track",t.entity); + if(cmd==22)action("media_player.media_next_track",t.entity); + if(cmd==23)action("media_player.volume_mute",t.entity,"is_volume_muted",t.muted?"false":"true"); + if(cmd==24)action("media_player.turn_on",t.entity); +} +// An off or standby player shows one key: power, when the player can be turned on from here. +inline bool media_off(const Tile &t){return t.state=="off" || t.state=="standby";} +inline std::string media_volume_text(const Tile &t){ + if(t.muted)return "Muted"; + if(!std::isfinite(t.volume))return ""; + return std::to_string((int)std::lround(std::clamp(t.volume,0.0f,1.0f)*100))+" %"; +} +// A rounded box without a style of its own: the art's placeholder, the bar's track and its fill. +inline lv_obj_t *media_box(lv_obj_t *parent,lv_obj_t *existing,const media_card::Rect &r,uint32_t color,int radius){ + auto *o=existing; + if(!o){o=lv_obj_create(parent);lv_obj_remove_style_all(o);lv_obj_set_style_bg_opa(o,LV_OPA_COVER,0);lv_obj_remove_flag(o,LV_OBJ_FLAG_CLICKABLE);lv_obj_remove_flag(o,LV_OBJ_FLAG_SCROLLABLE);} + lv_obj_set_pos(o,r.x,r.y);lv_obj_set_size(o,std::max(1,r.w),std::max(1,r.h)); + set_color(o,LV_STYLE_BG_COLOR,theme::rgb(color));set_number(o,LV_STYLE_RADIUS,radius); + return o; +} +// A round key: a glyph on a grey circle, the play key on the accent, the mute key bare beside the slider. Faded while +// it cannot be used. `existing` keeps a tile's key across redraws; the card builds its keys anew each time. +inline lv_obj_t *media_key(lv_obj_t *parent,lv_obj_t *existing,const media_card::Rect &r,const char *glyph,const lv_font_t *font,bool accent,bool bare,bool enabled,lv_event_cb_t cb,void *user){ + auto *key=existing; + if(!key){ + key=lv_obj_create(parent);lv_obj_remove_style_all(key); + lv_obj_set_style_radius(key,LV_RADIUS_CIRCLE,0);lv_obj_set_style_bg_opa(key,bare?LV_OPA_TRANSP:LV_OPA_COVER,0);lv_obj_set_style_bg_opa(key,LV_OPA_COVER,LV_STATE_PRESSED); + lv_obj_set_style_opa(key,LV_OPA_40,LV_STATE_DISABLED); + lv_obj_add_flag(key,LV_OBJ_FLAG_CLICKABLE);lv_obj_remove_flag(key,LV_OBJ_FLAG_SCROLLABLE); + lv_obj_set_ext_click_area(key,bare?10:6); + auto *icon=lv_label_create(key);lv_obj_remove_flag(icon,LV_OBJ_FLAG_CLICKABLE); + lv_obj_add_event_cb(key,cb,LV_EVENT_SHORT_CLICKED,user); + } + lv_obj_set_pos(key,r.x,r.y);lv_obj_set_size(key,r.w,r.h); + set_color(key,LV_STYLE_BG_COLOR,theme::color(accent?theme::ACCENT:theme::KEY)); + set_color(key,LV_STYLE_BG_COLOR,theme::color(accent?theme::ACCENT_PRESSED:theme::KEY_PRESSED),LV_STATE_PRESSED); + auto *icon=lv_obj_get_child(key,0); + if(font)set_font(icon,font); + set_color(icon,LV_STYLE_TEXT_COLOR,theme::color(accent?theme::ON_ACCENT:theme::INK)); + label(icon,glyph);lv_obj_center(icon); + if(enabled)lv_obj_remove_state(key,LV_STATE_DISABLED);else lv_obj_add_state(key,LV_STATE_DISABLED); + return key; +} +// The volume slider: the media colour on a pale track, a round white knob, the range every card slider has. +inline lv_obj_t *media_slider(lv_obj_t *parent,lv_obj_t *existing,const media_card::Rect &r,const Tile &t,bool large,bool enabled,void *user){ + auto *s=existing; + if(!s){ + s=lv_slider_create(parent);lv_obj_remove_style_all(s);lv_slider_set_range(s,0,1000); + lv_obj_set_style_bg_opa(s,LV_OPA_COVER,LV_PART_MAIN);lv_obj_set_style_bg_opa(s,LV_OPA_COVER,LV_PART_INDICATOR);lv_obj_set_style_bg_opa(s,LV_OPA_COVER,LV_PART_KNOB); + lv_obj_set_style_radius(s,LV_RADIUS_CIRCLE,LV_PART_MAIN);lv_obj_set_style_radius(s,LV_RADIUS_CIRCLE,LV_PART_INDICATOR);lv_obj_set_style_radius(s,LV_RADIUS_CIRCLE,LV_PART_KNOB); + lv_obj_set_style_pad_all(s,large?4:3,LV_PART_KNOB);lv_obj_set_style_bg_opa(s,LV_OPA_80,(lv_style_selector_t)LV_PART_KNOB|(lv_style_selector_t)LV_STATE_PRESSED); + lv_obj_set_style_opa(s,LV_OPA_40,LV_STATE_DISABLED); + lv_obj_set_ext_click_area(s,large?12:8); + lv_obj_add_event_cb(s,slider_event,LV_EVENT_ALL,user); + } + lv_obj_set_pos(s,r.x,r.y);lv_obj_set_size(s,std::max(1,r.w),r.h); + set_color(s,LV_STYLE_BG_COLOR,theme::rgb(theme::tint(theme::ha::LIGHT_BLUE,64)),LV_PART_MAIN); + set_color(s,LV_STYLE_BG_COLOR,theme::rgb(t.muted?theme::hex(theme::OFF):media_accent()),LV_PART_INDICATOR); + set_color(s,LV_STYLE_BG_COLOR,theme::color(theme::SLIDER_KNOB),LV_PART_KNOB); + if(!lv_obj_has_state(s,LV_STATE_PRESSED) && lv_slider_get_value(s)!=slider_value(t))lv_slider_set_value(s,slider_value(t),LV_ANIM_OFF); + if(enabled){lv_obj_remove_state(s,LV_STATE_DISABLED);lv_obj_add_flag(s,LV_OBJ_FLAG_CLICKABLE);} + else{lv_obj_add_state(s,LV_STATE_DISABLED);lv_obj_remove_flag(s,LV_OBJ_FLAG_CLICKABLE);} + return s; +} +// The cover over its placeholder: LVGL's image widget exists only on a board whose profile draws images. +inline lv_obj_t *media_picture_show(lv_obj_t *parent,lv_obj_t *existing,const media_card::Rect &r,lv_image_dsc_t *src){ +#if LV_USE_IMAGE + if(!src || !src->data)return existing; + auto *p=existing; + if(!p){p=lv_image_create(parent);lv_obj_remove_flag(p,LV_OBJ_FLAG_CLICKABLE);} + lv_image_set_src(p,src);lv_obj_set_pos(p,r.x,r.y);lv_obj_set_size(p,r.w,r.h);lv_obj_invalidate(p); + return p; +#else + (void)parent;(void)r;(void)src;return existing; +#endif +} +// The bar's fill and the elapsed time follow the track: once a second from tick(), without a redraw. +inline void media_progress(const Tile &t,lv_obj_t *fill,lv_obj_t *elapsed,int bar_w){ + const auto &x=t.extra(); + if(!fill || !x.media_duration)return; + const bool play=media_card::playing(t.state); + const int p=media_card::progress(x.media_position,x.media_position_at,now_epoch(),play,x.media_duration); + const int h=lv_obj_get_style_height(fill,LV_PART_MAIN); + const int w=std::max(h,bar_w*std::max(0,p)/1000); + if(lv_obj_get_style_width(fill,LV_PART_MAIN)!=w)lv_obj_set_width(fill,w); + if(elapsed)label(elapsed,media_card::clock_text(media_card::elapsed_seconds(x.media_position,x.media_position_at,now_epoch(),play,x.media_duration))); +} +// The card: everything under the top bar, from `top` down. +inline void render_media_detail(Tile &t,unsigned index,bool large,int width,int height,int top){ + using namespace media_card; + using namespace tile_controls; + const auto &x=t.extra(); + const Metrics m=media_metrics(large); + const Layout l=layout(m,width,std::max(60,height-top-(large?12:6))); + auto at=[&](Rect r){r.y+=top;return r;}; + const bool usable=fresh()&&t.available(),track=usable&&has_track(t.state),play=media_card::playing(t.state); + const uint32_t f=t.supported;auto can=[&](uint32_t bit){return usable&&(!f||(f&bit));}; + // The cover, or its placeholder with the player's icon; the cover comes over it once the app served it. + auto *frame=media_box(detail_root,nullptr,at(l.art),theme::tint(theme::ha::LIGHT_BLUE,51),l.art_radius); + const std::string glyph=icon_for(t); + const lv_font_t *placeholder_font=big_icon_font&&font_has(big_icon_font,glyph)?big_icon_font:tile_icon_font(); + auto *icon=lv_label_create(frame);lv_obj_remove_flag(icon,LV_OBJ_FLAG_CLICKABLE);lv_obj_set_style_text_font(icon,placeholder_font,0); + lv_obj_set_style_text_color(icon,theme::rgb(theme::icon(theme::ha::LIGHT_BLUE)),0);lv_label_set_text(icon,glyph.c_str());lv_obj_center(icon); + media_art_rect=at(l.art);media_detail_picture=nullptr; + const uint32_t ground=theme::hex(theme::PAGE); + if(camera_supported()&&track&&!x.media_picture.empty()){ + cover_want(t.entity,x.media_picture,l.art.w,ground,CoverOwner::DETAIL,0); + media_detail_picture=media_picture_show(detail_root,nullptr,media_art_rect,cover_ready(t.entity,l.art.w,ground)); + } + // Title, artist · album. + const lv_font_t *title_font=watch_font?watch_font:detail_font,*artist_font=control_font?control_font:detail_font,*small=small_font?small_font:detail_font; + const lv_text_align_t align=l.wide?LV_TEXT_ALIGN_LEFT:LV_TEXT_ALIGN_CENTER; + detail_text(detail_root,track&&!x.media_title.empty()?x.media_title:std::string(idle_text(usable?t.state:"unavailable")),l.title.x,l.title.y+top,l.title.w,title_font,align,theme::INK); + if(l.artist)detail_text(detail_root,track?subtitle(x.media_artist,x.media_album):std::string(),l.artist_line.x,l.artist_line.y+top,l.artist_line.w,artist_font,align,theme::MUTED); + // The progress bar: the fill runs while the track plays; a stream without a length has no bar to show. + media_progress_fill=nullptr;media_elapsed_label=nullptr;media_bar_width=l.bar.w; + if(track && x.media_duration){ + media_box(detail_root,nullptr,at(l.bar),theme::hex(theme::TRACK),LV_RADIUS_CIRCLE); + Rect fill=at(l.bar);fill.w=std::max(l.bar.h,l.bar.w*std::max(0,progress(x.media_position,x.media_position_at,now_epoch(),play,x.media_duration))/1000); + media_progress_fill=media_box(detail_root,nullptr,fill,media_accent(),LV_RADIUS_CIRCLE); + if(l.times){ + media_elapsed_label=detail_text(detail_root,clock_text(elapsed_seconds(x.media_position,x.media_position_at,now_epoch(),play,x.media_duration)),l.elapsed.x,l.elapsed.y+top,l.elapsed.w,small,LV_TEXT_ALIGN_LEFT,theme::SUBTLE); + detail_text(detail_root,clock_text(x.media_duration),l.total.x,l.total.y+top,l.total.w,small,LV_TEXT_ALIGN_RIGHT,theme::SUBTLE); + } + } + // The keys: previous, play or pause on the accent, next; the mute key bare at the start of the volume row. An off + // player shows one power key instead, and no volume row: it reports no volume. + auto cb=[](lv_event_t *e){detail_command((intptr_t)lv_event_get_user_data(e));}; + const lv_font_t *key_font=mini_icon_font?mini_icon_font:detail_font; + std::vector keys; + if(usable && media_off(t)){ + if(can(feature::MEDIA_TURN_ON))keys.push_back(media_key(detail_root,nullptr,at(l.play),glyph::POWER,tile_icon_font(),true,false,true,cb,(void*)(intptr_t)24)); + }else{ + keys={media_key(detail_root,nullptr,at(l.prev),glyph::PREVIOUS,key_font,false,false,can(feature::MEDIA_PREVIOUS),cb,(void*)(intptr_t)21), + media_key(detail_root,nullptr,at(l.play),play?glyph::PAUSE:glyph::PLAY,tile_icon_font(),true,false,can(feature::MEDIA_PLAY|feature::MEDIA_PAUSE),cb,(void*)(intptr_t)20), + media_key(detail_root,nullptr,at(l.next),glyph::NEXT,key_font,false,false,can(feature::MEDIA_NEXT),cb,(void*)(intptr_t)22)}; + if(std::isfinite(t.volume)){ + keys.push_back(media_key(detail_root,nullptr,at(l.mute),t.muted?glyph::MUTED:glyph::VOLUME,key_font,false,true,can(feature::MEDIA_VOLUME_MUTE),cb,(void*)(intptr_t)23)); + media_slider(detail_root,nullptr,at(l.volume),t,large,can(feature::MEDIA_VOLUME_SET),(void*)(uintptr_t)index); + detail_text(detail_root,media_volume_text(t),l.percent.x,l.percent.y+top,l.percent.w,small,LV_TEXT_ALIGN_RIGHT,theme::MUTED); + } + } + // Only the keys the player supports join the card's actions: tick() enables those again after a wait, and a key + // the player lacks stays faded. + for(auto *k:keys)if(!lv_obj_has_state(k,LV_STATE_DISABLED) && detail_action_count<32)detail_actions[detail_action_count++]=k; +} inline void show_detail(unsigned index){ if(index>=model.count)return; // A card that opens starts on a day (an hour for a tile whose graph shows one); switching ranges keeps it open. @@ -1739,7 +1932,8 @@ inline void show_detail(unsigned index){ detail_index=index;auto &t=model.tiles[index]; if(!detail_font)detail_font=lv_obj_get_style_text_font(widgets[0].title,LV_PART_MAIN); if(!detail_root){detail_root=lv_obj_create(lv_screen_active());lv_obj_remove_style_all(detail_root);lv_obj_set_size(detail_root,lv_pct(100),lv_pct(100));lv_obj_remove_flag(detail_root,LV_OBJ_FLAG_SCROLLABLE);} - detail_action_count=0;detail_status=nullptr;detail_badge_status=nullptr;detail_switch=nullptr;history_forget();lv_obj_clean(detail_root);lv_obj_remove_flag(detail_root,LV_OBJ_FLAG_HIDDEN);lv_obj_move_foreground(detail_root); + detail_action_count=0;detail_status=nullptr;detail_badge_status=nullptr;detail_switch=nullptr;history_forget(); + media_progress_fill=nullptr;media_elapsed_label=nullptr;media_detail_picture=nullptr;lv_obj_clean(detail_root);lv_obj_remove_flag(detail_root,LV_OBJ_FLAG_HIDDEN);lv_obj_move_foreground(detail_root); lv_obj_set_style_bg_color(detail_root,theme::color(theme::PAGE),0);lv_obj_set_style_bg_opa(detail_root,LV_OPA_COVER,0); int width=lv_display_get_horizontal_resolution(lv_display_get_default()), height=lv_display_get_vertical_resolution(lv_display_get_default()); bool large=width>=480;int pad=large?20:10, top=large?100:62, gap=large?12:6,bh=large?58:34,cw=(width-pad*2-gap)/2; @@ -1754,7 +1948,7 @@ inline void show_detail(unsigned index){ std::string state=d=="cover"?cover_status_line(t):detail_state(t); // The vacuum and history cards draw their own state. const bool with_history=history_card(t); - if(d!="vacuum"&&!with_history){detail_status=detail_label(detail_root,state+(t.unit.empty()?"":" "+t.unit),pad,large?80:50,width-2*pad);lv_obj_set_style_text_align(detail_status,LV_TEXT_ALIGN_CENTER,0);lv_obj_set_style_text_color(detail_status,theme::color(theme::MUTED),0);} + if(d!="vacuum"&&d!="media_player"&&!with_history){detail_status=detail_label(detail_root,state+(t.unit.empty()?"":" "+t.unit),pad,large?80:50,width-2*pad);lv_obj_set_style_text_align(detail_status,LV_TEXT_ALIGN_CENTER,0);lv_obj_set_style_text_color(detail_status,theme::color(theme::MUTED),0);} if(with_history){ render_history_detail(t,large,width,height,pad); }else if(d=="vacuum"){ @@ -1766,12 +1960,8 @@ inline void show_detail(unsigned index){ const auto &options=t.extra().options; for(unsigned i=0;i=widgets.size() || n>3)return; + auto &w=widgets[slot]; + if(!enabled || !fresh() || w.index>=model.count || w.extra_mode!="media")return; + if(lv_obj_has_state(lv_event_get_target_obj(e),LV_STATE_DISABLED))return; + const uint32_t now=esphome::millis(); + if(!allowed(now,500+slot*16+n,"media key "+std::to_string(slot)))return; + auto &t=model.tiles[w.index]; + if(!t.available() || t.waiting(now))return; + static const int commands[]={21,20,22,23}; + media_action(t,n==1 && media_off(t)?24:commands[n]); +} +inline void render_media_full(Widgets &w,const Tile &t,bool big,int content_w,int content_h,int head_h){ + using namespace media_card; + using namespace tile_controls; + const auto &x=t.extra(); + const Metrics m=media_metrics(big); + const int top=head_h+(big?8:4); + const Layout l=layout(m,content_w,std::max(40,content_h-top-(big?4:2))); + begin_extra(w,"media",content_w,content_h); + auto at=[&](Rect r){r.y+=top;return r;}; + const bool usable=fresh()&&t.available(),track=usable&&has_track(t.state),play=media_card::playing(t.state); + const uint32_t f=t.supported;auto can=[&](uint32_t bit){return usable&&(!f||(f&bit));}; + const size_t slot=&w-widgets.data(); + // The placeholder and the player's icon; the cover comes over them once the app served it. + w.parts[0]=media_box(w.extra,w.parts[0],at(l.art),theme::tint(theme::ha::LIGHT_BLUE,51),l.art_radius); + const std::string glyph=icon_for(t); + const lv_font_t *placeholder_font=big_icon_font&&font_has(big_icon_font,glyph)?big_icon_font:w.icon_font; + if(!w.parts[1]){w.parts[1]=lv_label_create(w.parts[0]);lv_obj_remove_flag(w.parts[1],LV_OBJ_FLAG_CLICKABLE);} + set_font(w.parts[1],placeholder_font);set_color(w.parts[1],LV_STYLE_TEXT_COLOR,theme::rgb(theme::icon(theme::ha::LIGHT_BLUE)));label(w.parts[1],glyph);lv_obj_center(w.parts[1]); + const uint32_t ground=theme::of(lv_obj_get_style_bg_color(w.tile,LV_PART_MAIN)); + lv_image_dsc_t *src=nullptr; + // A card open over the page owns the cover then; the tile asks again once the card closes (cover_tick). + const bool card_open=detail_root && !lv_obj_has_flag(detail_root,LV_OBJ_FLAG_HIDDEN); + if(camera_supported()&&track&&!x.media_picture.empty()&&!card_open){cover_want(t.entity,x.media_picture,l.art.w,ground,CoverOwner::TILE,slot);src=cover_ready(t.entity,l.art.w,ground);} + if(src)w.parts[MEDIA_PICTURE]=media_picture_show(w.extra,w.parts[MEDIA_PICTURE],at(l.art),src); + else if(w.parts[MEDIA_PICTURE]){lv_obj_delete(w.parts[MEDIA_PICTURE]);w.parts[MEDIA_PICTURE]=nullptr;} + // Title, artist · album, left-aligned beside the cover. + const lv_font_t *title_font=watch_font?watch_font:w.title_font,*artist_font=control_font?control_font:w.title_font,*small=small_font?small_font:w.title_font; + auto text=[&](unsigned i,const lv_font_t *font,const Rect &r,lv_text_align_t align,const std::string &value,theme::Role role){ + auto *p=part_label(w,i,font,r.x,r.y+top,r.w,align,value);lv_label_set_long_mode(p,LV_LABEL_LONG_DOT);set_color(p,LV_STYLE_TEXT_COLOR,theme::color(role));lv_obj_remove_flag(p,LV_OBJ_FLAG_HIDDEN);return p; + }; + text(2,title_font,l.title,LV_TEXT_ALIGN_LEFT,track&&!x.media_title.empty()?x.media_title:std::string(idle_text(usable?t.state:"unavailable")),theme::INK); + if(l.artist)text(3,artist_font,l.artist_line,LV_TEXT_ALIGN_LEFT,track?subtitle(x.media_artist,x.media_album):std::string(),theme::MUTED); + else if(w.parts[3])lv_obj_add_flag(w.parts[3],LV_OBJ_FLAG_HIDDEN); + // The progress bar and its times; a stream without a length has none. + w.media_bar_w=l.bar.w; + const bool timed=track&&x.media_duration; + if(timed){ + w.parts[4]=media_box(w.extra,w.parts[4],at(l.bar),theme::hex(theme::TRACK),LV_RADIUS_CIRCLE);lv_obj_remove_flag(w.parts[4],LV_OBJ_FLAG_HIDDEN); + Rect fill=at(l.bar);fill.w=std::max(l.bar.h,l.bar.w*std::max(0,progress(x.media_position,x.media_position_at,now_epoch(),play,x.media_duration))/1000); + w.parts[5]=media_box(w.extra,w.parts[5],fill,media_accent(),LV_RADIUS_CIRCLE);lv_obj_remove_flag(w.parts[5],LV_OBJ_FLAG_HIDDEN); + }else for(unsigned i:{4u,5u})if(w.parts[i])lv_obj_add_flag(w.parts[i],LV_OBJ_FLAG_HIDDEN); + if(timed&&l.times){ + text(6,small,l.elapsed,LV_TEXT_ALIGN_LEFT,clock_text(elapsed_seconds(x.media_position,x.media_position_at,now_epoch(),play,x.media_duration)),theme::SUBTLE); + text(7,small,l.total,LV_TEXT_ALIGN_RIGHT,clock_text(x.media_duration),theme::SUBTLE); + }else for(unsigned i:{6u,7u})if(w.parts[i])lv_obj_add_flag(w.parts[i],LV_OBJ_FLAG_HIDDEN); + // The keys and the volume row. Their events carry the slot: the tile in it may change with the page. An off player + // shows one power key and no volume row. + const lv_font_t *key_font=mini_icon_font?mini_icon_font:w.icon_font; + auto user=[&](unsigned n){return (void*)(uintptr_t)(slot*16+n);}; + auto show=[&](unsigned i,bool on){if(w.parts[i]){if(on)lv_obj_remove_flag(w.parts[i],LV_OBJ_FLAG_HIDDEN);else lv_obj_add_flag(w.parts[i],LV_OBJ_FLAG_HIDDEN);}}; + const bool off=usable && media_off(t), volume=!off && std::isfinite(t.volume); + if(off){ + w.parts[9]=media_key(w.extra,w.parts[9],at(l.play),glyph::POWER,w.icon_font,true,false,can(feature::MEDIA_TURN_ON),media_tile_key_event,user(1)); + show(9,can(feature::MEDIA_TURN_ON)); + }else{ + w.parts[8]=media_key(w.extra,w.parts[8],at(l.prev),glyph::PREVIOUS,key_font,false,false,can(feature::MEDIA_PREVIOUS),media_tile_key_event,user(0)); + w.parts[9]=media_key(w.extra,w.parts[9],at(l.play),play?glyph::PAUSE:glyph::PLAY,w.icon_font,true,false,can(feature::MEDIA_PLAY|feature::MEDIA_PAUSE),media_tile_key_event,user(1)); + w.parts[10]=media_key(w.extra,w.parts[10],at(l.next),glyph::NEXT,key_font,false,false,can(feature::MEDIA_NEXT),media_tile_key_event,user(2)); + show(9,true); + } + show(8,!off);show(10,!off); + if(volume){ + w.parts[11]=media_key(w.extra,w.parts[11],at(l.mute),t.muted?glyph::MUTED:glyph::VOLUME,key_font,false,true,can(feature::MEDIA_VOLUME_MUTE),media_tile_key_event,user(3)); + w.parts[12]=media_slider(w.extra,w.parts[12],at(l.volume),t,big,can(feature::MEDIA_VOLUME_SET),(void*)(uintptr_t)w.index); + text(13,small,l.percent,LV_TEXT_ALIGN_RIGHT,media_volume_text(t),theme::MUTED); + } + show(11,volume);show(12,volume);show(13,volume); +} inline void render_full(Widgets &w,const Tile &t,bool custom,bool clock,bool sunpath,bool graph,bool mini,bool with_panel,bool large, const std::string &value,const std::string &unit,int content_w,int content_h) { const bool big=w.base_height>80; // the board: a Guition card is large, a CYD card small @@ -2610,7 +2885,9 @@ inline void render_full(Widgets &w,const Tile &t,bool custom,bool clock,bool sun } int value_h=lv_font_get_line_height(lv_obj_get_style_text_font(w.value,LV_PART_MAIN)); int gap=big?12:6; - if(!mini && !with_panel && !graph){ + // A media player that answers gets the media card under its head (firmware 0.2.64+); unavailable, it is the plain card. + const bool media=t.domain()=="media_player" && fresh() && t.available(); + if(!mini && !with_panel && !graph && !media){ hide_extra(w);hide_panel(w);lv_obj_add_flag(w.slider,LV_OBJ_FLAG_HIDDEN); const lv_font_t *name_font=room_label?lv_obj_get_style_text_font(room_label,LV_PART_MAIN):w.title_font; int name_h=lv_font_get_line_height(name_font),circle=big?128:64; @@ -2638,6 +2915,11 @@ inline void render_full(Widgets &w,const Tile &t,bool custom,bool clock,bool sun lv_obj_set_pos(w.title,w.title_x,big?w.title_y:text_y); lv_obj_set_pos(w.value,w.value_x,big?w.value_y:text_y+title_h+line_gap); lv_obj_set_width(w.title,std::max(1,content_w-w.title_x));lv_obj_set_width(w.value,std::max(1,content_w-w.value_x)); + if(media){ + hide_panel(w);lv_obj_add_flag(w.slider,LV_OBJ_FLAG_HIDDEN); + render_media_full(w,t,big,content_w,content_h,head_h); + return; + } if(mini){ // The small slider becomes a strip a thumb finds at the bottom; the room above it is the button. hide_extra(w);hide_panel(w); @@ -2705,6 +2987,8 @@ inline void render_slot(size_t slot) { else if (value == "docked") value = "Docked"; // Home Assistant's word where the screen has none of its own (firmware 0.2.58+): a cover says Open, a washer Rinsing. else if (!t.extra().state_word.empty()) value = t.extra().state_word; + // A player's state in the screen's own words where Home Assistant sent none (firmware 0.2.64+). + else if (d == "media_player") value = tile_controls::media_state_text(t.state); else if (!t.unit.empty() && !watch) value += " " + t.unit; bool pending=t.loading(esphome::millis()); if(d=="weather" && std::isfinite(t.current)) {char b[32];snprintf(b,sizeof(b),"%.1f %s",t.current,t.unit.c_str());value=b;if(watch){snprintf(b,sizeof(b),"%.1f",t.current);value=b;}} @@ -2851,7 +3135,9 @@ inline void render_slot(size_t slot) { // The sun path sets its own colours on every render, the sunlit area under its arc too: taking the // accent here made that area orange after a palette change and yellow again after the next minute. if(w.extra_mode!="sunpath")w.fill_color=color; - for(unsigned i=0;i=2 && i%3==2 : w.extra_mode=="sunpath" ? i>=1 : w.extra_mode=="calendar" ? i==15||i==17 : i==16; if(lv_obj_check_type(p,&lv_label_class))set_color(p,LV_STYLE_TEXT_COLOR,muted?value_color:title_color); @@ -3411,6 +3697,9 @@ inline void tick() { uint32_t second=esphome::millis()/1000; if(second!=last_live_second){ last_live_second=second; + // The media card's bar runs on while the track plays (firmware 0.2.64+). + if(media_progress_fill && detail_root && !lv_obj_has_flag(detail_root,LV_OBJ_FLAG_HIDDEN) && detail_index=model.count || lv_obj_has_flag(w.tile,LV_OBJ_FLAG_HIDDEN))continue; const auto &t=model.tiles[w.index]; if((t.is_clock() && new_minute) || (t.domain()=="timer" && t.state=="active") || (t.domain()=="sun" && second%60==0))card(w.index); + // A media tile over the whole page: its bar runs on while the track plays (firmware 0.2.64+). + if(w.extra_mode=="media" && w.extra && !lv_obj_has_flag(w.extra,LV_OBJ_FLAG_HIDDEN) && w.parts[5] && !lv_obj_has_flag(w.parts[5],LV_OBJ_FLAG_HIDDEN))media_progress(t,w.parts[5],w.parts[6],w.media_bar_w); // The second hand moves on its own: only its line is redrawn, and it hides during standby. Only while the // slot's parts are a dial: right after a page switch the slot already names the clock while its parts still // belong to the card drawn before (a forecast's hour labels take part 18 too), until the fill draws the dial. @@ -3473,15 +3764,102 @@ constexpr uint8_t ALERT_IMAGE_RETRIES = 3; // an alert's picture is worth anoth inline bool camera_supported() { return static_cast(camera_full.load); } inline bool camera_visible() { return camera_root != nullptr; } +// ---- The album cover of the media card (firmware 0.2.64+) ---- +// The card, or a media tile over the whole page, says which cover it wants: the player, the mark of its picture, the +// size and the colour behind the rounded corners (cover_want). The app answers `esphome.screen_camera` with a link to +// a BMP of exactly that (op "camera", t "cover"); the board's full online_image loads it once and the picture stays +// until the mark changes, the owner goes (the card closes, the page turns) or a camera opens full screen: the camera +// and the cover share that one image buffer, and the camera wins. Everything runs from camera_tick(). +struct CoverWish { std::string entity, picture; int size = 0; uint32_t background = 0; CoverOwner owner = CoverOwner::NONE; size_t slot = 0; }; +inline CoverWish cover_wish; +inline camera_view::Feed cover; +inline void camera_release(); +inline void camera_request(const std::string &entity, int size = 0, uint32_t background = 0); +// The pictures on screen go before their buffer does. +inline void cover_forget_pictures() { + if (media_detail_picture) { lv_obj_delete(media_detail_picture); media_detail_picture = nullptr; } + for (auto &w : widgets) if (w.extra_mode == "media" && w.parts[MEDIA_PICTURE]) { lv_obj_delete(w.parts[MEDIA_PICTURE]); w.parts[MEDIA_PICTURE] = nullptr; } +} +inline void cover_release() { + const bool had = cover.open(); + cover = camera_view::Feed{}; + cover_forget_pictures(); + if (had && !camera_root) camera_release_due = true; +} +inline void cover_want(const std::string &entity, const std::string &picture, int size, uint32_t background, CoverOwner owner, size_t slot) { + if (!camera_supported()) return; + const bool same = cover_wish.entity == entity && cover_wish.picture == picture && cover_wish.size == size && cover_wish.background == background; + cover_wish = CoverWish{entity, picture, size, background, owner, slot}; + if (same) return; + cover_release(); // another cover: asked for on the next tick +} +inline lv_image_dsc_t *cover_ready(const std::string &entity, int size, uint32_t background) { + if (!cover.loaded || cover.entity != entity || cover_wish.size != size || cover_wish.background != background) return nullptr; + auto *src = camera_full.source(); + return src && src->data ? src : nullptr; +} +inline void cover_drop() { cover_wish = CoverWish{}; cover_release(); } +// Whether the owner still shows the cover: the card open on that player, or the tile on screen in its slot. +inline bool cover_visible() { + if (cover_wish.owner == CoverOwner::DETAIL) + return detail_root && !lv_obj_has_flag(detail_root, LV_OBJ_FLAG_HIDDEN) && detail_index < model.count && model.tiles[detail_index].entity == cover_wish.entity; + if (cover_wish.owner == CoverOwner::TILE && cover_wish.slot < widgets.size()) { + if (detail_root && !lv_obj_has_flag(detail_root, LV_OBJ_FLAG_HIDDEN)) return false; // a card covers the page + auto &w = widgets[cover_wish.slot]; + return w.tile && !lv_obj_has_flag(w.tile, LV_OBJ_FLAG_HIDDEN) && w.index < model.count && model.tiles[w.index].entity == cover_wish.entity && w.extra_mode == "media"; + } + return false; +} +// Nobody holds the cover and a media tile with a picture is on the page (the card over it just closed, or the +// page turned): the tile draws itself again and asks. +inline void cover_offer() { + if (detail_root && !lv_obj_has_flag(detail_root, LV_OBJ_FLAG_HIDDEN)) return; + for (auto &w : widgets) { + if (!w.tile || lv_obj_has_flag(w.tile, LV_OBJ_FLAG_HIDDEN) || w.index >= model.count || w.extra_mode != "media") continue; + const auto &t = model.tiles[w.index]; + if (t.extra().media_picture.empty() || !media_card::has_track(t.state)) continue; + refresh_tile(w.index); + return; + } +} +// The cover is here: onto the card at once, or the tile draws itself again with it. +inline void cover_arrived() { + if (!cover_visible()) return; + if (cover_wish.owner == CoverOwner::DETAIL) media_detail_picture = media_picture_show(detail_root, media_detail_picture, media_art_rect, camera_full.source()); + else refresh_tile(widgets[cover_wish.slot].index); + ESP_LOGI("camera", "cover of %s shown", cover.entity.c_str()); +} +inline void cover_tick(uint32_t now) { + if (camera_root || !camera_supported()) return; + if (cover_wish.owner == CoverOwner::NONE) { cover_offer(); return; } + if (!cover_visible()) { cover_drop(); return; } + if (!awake()) return; + if (!cover.open()) cover.open(cover_wish.entity, true); + if (cover.should_ask(now)) { + if (!fresh()) return; + cover.ask(now); + camera_request(cover.entity, cover_wish.size, cover_wish.background); + } else if (cover.should_load(now)) { + auto *input = lv_indev_get_next(nullptr); + if (input && lv_indev_get_state(input) == LV_INDEV_STATE_PRESSED) return; + cover.start(now); + camera_full.load(cover.url); + } +} + // Asks ESP Screen Manager for a link (app 0.2.66+ answers with op "camera"). An event, like history_request. -inline void camera_request(const std::string &entity) { +// A cover (firmware 0.2.64+) adds the size it wants and the colour behind its rounded corners; the app bakes both in. +inline void camera_request(const std::string &entity, int size, uint32_t background) { if (inbox.empty()) return; esphome::api::HomeassistantActionRequest request; request.service = esphome::StringRef("esphome.screen_camera"); request.is_event = true; - const std::string keys[] = {"inbox", "entity"}, values[] = {inbox, entity}; - request.data.init(2); - for (int i = 0; i < 2; ++i) { + char size_text[12] = "", background_text[8] = ""; + if (size > 0) { snprintf(size_text, sizeof(size_text), "%d", size); snprintf(background_text, sizeof(background_text), "%06X", (unsigned) background); } + const std::string keys[] = {"inbox", "entity", "size", "bg"}, values[] = {inbox, entity, size_text, background_text}; + const int count = size > 0 ? 4 : 2; + request.data.init(count); + for (int i = 0; i < count; ++i) { esphome::api::HomeassistantServiceMap entry; entry.key = esphome::StringRef(keys[i]); entry.value = esphome::StringRef(values[i]); @@ -3515,7 +3893,9 @@ inline void camera_close() { inline void camera_open(const std::string &entity, const std::string &name) { if (!camera_supported() || !valid_entity(entity)) return; camera_close(); - // The last camera's image goes before this one loads into the same online_image. + // The last camera's image, or a media card's cover, goes before this one loads into the same online_image; the + // cover is asked for again once the camera closes (cover_tick). + cover_release(); if (camera_release_due) camera_release(); camera.open(entity); const int width = lv_display_get_horizontal_resolution(lv_display_get_default()); @@ -3577,6 +3957,7 @@ inline void camera_tick() { camera_thumb.load(alert_url); } } + cover_tick(now); if (!camera_root || !awake()) return; if (camera.should_ask(now)) { if (!fresh()) return; @@ -3631,6 +4012,12 @@ inline void camera_answer(const std::string &view, const std::string &entity, co if (url.empty() && !camera.shown) camera_note_text("No image from this camera"); return; } + if (view == "cover") { // the media card's album cover (firmware 0.2.64+) + if (!cover.open() || cover.entity != entity) return; + cover.link(url); + if (url.empty()) ESP_LOGI("camera", "no cover for %s", entity.c_str()); + return; + } if (url.empty()) { // announced before its alert alert_announced = entity; alert_announced_at = esphome::millis(); @@ -3674,7 +4061,12 @@ inline void camera_loaded(bool thumb, bool cached) { if (alert_picture && alert_frame_icon) lv_obj_add_flag(alert_frame_icon, LV_OBJ_FLAG_HIDDEN); return; } - if (!camera_root) return; + if (!camera_root) { + // The media card's cover (firmware 0.2.64+): the same online_image, loaded once. + if (cover.loading) { cover.finish(esphome::millis(), true); cover_arrived(); } + return; + } + if (!camera.loading) return; // a cover's download that ended after the camera opened: not this camera's picture camera.finish(esphome::millis(), true); const bool first = camera_picture == nullptr; camera_show(camera_root, camera_picture, camera_full.source(), !cached); @@ -3694,7 +4086,11 @@ inline void camera_failed(bool thumb) { } return; } - if (!camera_root) return; + if (!camera_root) { + if (cover.loading) cover.finish(esphome::millis(), false); // tried again after the gap, three times at most + return; + } + if (!camera.loading) return; camera.finish(esphome::millis(), false); if (!camera.shown) camera_note_text("No image from this camera"); } diff --git a/components/smart_display/theme.h b/components/smart_display/theme.h index 35b7639..91ff1d0 100644 --- a/components/smart_display/theme.h +++ b/components/smart_display/theme.h @@ -279,6 +279,9 @@ namespace theme { inline lv_color_t color(Role role) { return lv_color_hex(hex(role)); } inline lv_color_t rgb(uint32_t value) { return lv_color_hex(value); } +// The colour an object draws with, as the 24-bit value the table speaks in (what the media card names as the colour +// behind its cover's corners). +inline uint32_t of(lv_color_t value) { return lv_color_to_u32(value) & 0xFFFFFF; } // ---- paints: shared styles filled from the table // A board profile gives a widget a paint instead of a colour (`styles: paint_card`). Its style definitions carry no diff --git a/components/smart_display/tile_controls.h b/components/smart_display/tile_controls.h index b458d66..83360ff 100644 --- a/components/smart_display/tile_controls.h +++ b/components/smart_display/tile_controls.h @@ -16,7 +16,7 @@ namespace tile_controls { namespace feature { constexpr uint32_t COVER_OPEN = 1, COVER_CLOSE = 2, COVER_POSITION = 4, COVER_STOP = 8; constexpr uint32_t COVER_OPEN_TILT = 16, COVER_CLOSE_TILT = 32, COVER_STOP_TILT = 64, COVER_TILT_POSITION = 128; -constexpr uint32_t MEDIA_PAUSE = 1, MEDIA_VOLUME_SET = 4, MEDIA_VOLUME_MUTE = 8, MEDIA_PREVIOUS = 16, MEDIA_NEXT = 32, MEDIA_PLAY = 16384; +constexpr uint32_t MEDIA_PAUSE = 1, MEDIA_VOLUME_SET = 4, MEDIA_VOLUME_MUTE = 8, MEDIA_PREVIOUS = 16, MEDIA_NEXT = 32, MEDIA_TURN_ON = 128, MEDIA_PLAY = 16384; constexpr uint32_t VACUUM_TURN_ON = 1, VACUUM_TURN_OFF = 2, VACUUM_PAUSE = 4, VACUUM_STOP = 8, VACUUM_RETURN = 16, VACUUM_START = 8192; } // Material Design Icons glyphs the icon fonts carry (tile_icons.py FIXED). diff --git a/docs/CAMERA.md b/docs/CAMERA.md index 0131dba..24f48ef 100644 --- a/docs/CAMERA.md +++ b/docs/CAMERA.md @@ -13,6 +13,23 @@ The CYD has no memory for images (a 320×180 image needs 115 KB in one piece, th free block is about 45 KB). It shows the alert without the picture, and the editor doesn't offer camera tiles for it. +## The album cover on the media card + +App 0.2.77 with firmware 0.2.64 uses the same road for a media player's picture. The media card +(a tap on a media player's tile, or a media tile of size *Full page*) shows the album cover of +what plays, with the title, the artist and the album, a progress bar and the keys under it. + +- The screen asks ESP Screen Manager for the cover with the size it draws it at and the colour + behind it (the event `esphome.screen_camera` with `size` and `bg`). The app fetches the + picture where Home Assistant's state points (`entity_picture`), cuts it square, sizes it, + rounds the corners over that colour and serves it on port 8098 as a BMP, like a camera image. +- A cover is fetched once per picture: the state carries a short mark of the picture, and the + screen asks again only when the mark changes (a new track), when the card opens again or + when the page turns back to a full-page media tile. Nothing polls. +- A player without a picture (a radio station, a player that is off) keeps the player's icon in + the cover's place; the app answers with an empty link and the screen stops asking. +- The CYD shows the same card without the picture: its icon stands in for the cover. + ## A doorbell ```yaml diff --git a/docs/TEST_RESULTS_0277.md b/docs/TEST_RESULTS_0277.md new file mode 100644 index 0000000..3ea0857 --- /dev/null +++ b/docs/TEST_RESULTS_0277.md @@ -0,0 +1,85 @@ +# Test results app 0.2.77 / firmware 0.2.64 (2026-09-18) + +Max asked for a media card "like Spotify or Apple Music now playing" instead of the plain card with three text keys +and a thin volume slider, with the album cover through the camera-image route, working as the card behind a media +tile, as a tile over the whole page, and in the light and the dark look. Then: the CYD gets the new card without the +picture ("te risky"), a player does not always have a picture, and renders first so he could approve the look. +See CHANGELOG 0.2.77. Built on 0.2.76 (`bdb1f12`). + +## What changed + +- `components/smart_display/media_card.h` (new): the card's geometry and words, free of LVGL. A tall area (the + Guition's card) stacks cover, title, artist · album, the bar row (elapsed | bar | total on one line), the keys + (previous 52, play or pause 64 on the accent, next) and the volume row. A wide area (the CYD's card, a tile over the + whole page) puts the cover at the left with the column beside it; what does not fit goes in order: the artist line, + the times, then the cover shrinks. `tests/test_media_card.cpp` checks every shape for overlaps and order. +- `runtime_tiles.h`: `render_media_detail` (the card), `render_media_full` (the tile over the whole page, parts in + `w.extra`), `media_action` shared by both (20 play/pause, 21 previous, 22 next, 23 mute, 24 turn on), the card's + key handler pulled out of `detail_button` into `detail_command`, `media_progress` moved by `tick()` once a second, + and the cover: `cover_want`/`cover_ready`/`cover_tick`/`cover_offer` around one `camera_view::Feed` that loads a + link once (`once`, `loaded`), owned by the card or by a tile slot and dropped when the owner goes; a camera full + screen takes the shared image buffer and the cover comes back after. The camera answer parser accepts `t: cover`. + The palette pass leaves the media tile's parts alone (it painted them the card's grey). A player's state falls + back to the screen's own word ("Playing") when Home Assistant sent none. +- `runtime_model.h`: `Extra` carries artist, album, picture mark, duration, position and its moment. +- `camera_view.h`: `open(entity, once)`, `loaded`; an empty answer to a one-time feed stops the asking. +- `theme.h`: `theme::of(lv_color_t)` (the 24-bit value of a drawn colour, for the cover's corner colour). +- `tile_controls.h`: `feature::MEDIA_TURN_ON`. +- App: `core.media_extras` (`x: artist, album, dur, pos, at, pic`), `COVER_MIN_FIRMWARE = 0.2.64`; + `camera_feed.cover_supported/can_show_cover/cover_request/encode_cover`, `CameraFeed.cover()` (fetched when the + picture address changed), `Link.cover`; `server.HomeAssistant.media_picture/media_image`, `Manager.cover_message`, + `answer_camera` serves covers to a Guition on 0.2.64+ for players on its layout. +- Both profiles: firmware 0.2.64. Docs: CHANGELOG, README rows, docs/CAMERA.md "The album cover on the media card". + +## Checks + +- `tests/test_media_card.cpp` (geometry, progress, clock text, subtitle), `tests/test_camera_view.cpp` (one-time + feed), all 18 C++ suites: pass. +- `tests/test_media_card.py` (14): extras, firmware wiring, cover encoding (corners, square crop, transparency), + fetch-on-change and links, the app's answer through `Manager.answer_camera` (Guition 0.2.64 gets a link, a stream + an empty one, a stranger nothing, older firmware and a CYD nothing). Whole Python suite: 409 + 14, pass. +- Host harness (`.esphome/readme-render/media/media_host.py`, real ESPHome API, virtual finger, the app's own + `answer_camera` behind `/dev/cover`): **Guition 57/57, CYD 42/42.** Covered: the card of a playing player (title, + artist · album, elapsed from the reported position and running on, keys enabled, slider at 32 %, bar track and + fill), the cover asked for with size and page colour and loaded once over the placeholder, pause → `media_play_pause` + with the keys faded during the wait and back after, next, mute (`is_volume_muted: true`), the slider drag → + `volume_set` ≈ 0.8, closing drops the cover; a stream (no times, no cover request); a paused muted TV with few + features (play key, muted key, "Muted", next and mute faded, previous not, a still bar, its cover); an off player + ("Off", no times); dark mode (dark keys, the cover asked again with the dark page colour); a tile over the whole + page (track beside the cover, keys, slider, "48 %", times, cover at the tile's size and colour, the bar running, + the tile's pause key acting on the study speaker without opening the card, the tile's slider → `volume_set` ≈ 0.2, + a new picture in Home Assistant → new mark → the tile asks again and loads the new cover, holding the tile opens the + card which takes the cover at its own size, closing gives it back to the tile); a stream over the page (no times, + no cover, the study cover dropped); an idle player ("Not playing"); a wide media tile with a volume control keeps + its panel; no errors in the firmware log. The CYD asks for no cover anywhere. +- Renders (`render_media.py`, both boards, light and dark): card of a playing player, a stream, a paused TV, an off + player, tiles over the page (study, radio, idle). Sent to Max for approval. +- ESP32 builds of both Easy Setup profiles: see the sizes below. +- Hardware: Studio 1 (Guition, this network's Home Assistant) — see below. + +## Sizes + +Both Easy Setup profiles compile with ESPHome 2026.6.2 (on Python 3.11, see the pitfalls), no warnings. + +| Build | Flash | RAM | +|---|---|---| +| Guition (easy-guition-device) | 1,971,583 B, 24.3 % of 8 MB | 76,844 B, 23.5 % | +| CYD (easy-cyd-device) | 1,582,063 B, 86.2 % of the 1.835 MB update slot | 71,276 B, 21.8 % | + +## Hardware + +Pending at the time of writing. + +## Pitfalls + +- `render_time` on a host build freezes the clock, and the progress bar with it: the harness shifts the demo's + report moments to now instead. +- LVGL's `LV_LABEL_LONG_DOT` writes the dots into the label's text: a probe sees "Miles Davis · Kin...". +- `tick()` re-enables every object in `detail_actions` after a wait: a key the player lacks must stay out of it. +- The tile palette pass paints every custom part; a mode that paints its own parts must be skipped there. +- Homebrew's python@3.14.7 on this Mac has a broken `pyexpat` (it wants a libexpat symbol macOS 26.2 lacks), so + `platform.mac_ver()` returns '' and both pip's truststore and `uv` refuse the interpreter. The pioarduino platform + recreates `~/.platformio/penv` from the running Python and then cannot install into it. The ESP32 builds of this + release ran from an ESPHome 2026.6.2 environment on PlatformIO's own bundled Python 3.11 (`.esphome/venv311`, + local); `brew reinstall python@3.14` (or expat) is the real fix. Also: never run two ESPHome builds at once, the + second one clears the penv the first one uses. diff --git a/docs/images/cyd-dark-media.png b/docs/images/cyd-dark-media.png new file mode 100644 index 0000000000000000000000000000000000000000..6374872b25fc167c0f7835e173f7da345353f2ea GIT binary patch literal 11789 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 cik=rI@qT;z>49Lc2n`zI^NJMzD6w01$#7wdl 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 literal 0 HcmV?d00001 diff --git a/docs/images/cyd-media.png b/docs/images/cyd-media.png new file mode 100644 index 0000000000000000000000000000000000000000..ae141b0706c85efd9187d375ed6579198a82adf1 GIT binary patch literal 11725 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 literal 0 HcmV?d00001 diff --git a/docs/images/guition-media-full.png b/docs/images/guition-media-full.png new file mode 100644 index 0000000000000000000000000000000000000000..976dda82cf2d5f8eef665507673b2657d1649571 GIT binary patch literal 37824 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 literal 0 HcmV?d00001 diff --git a/docs/images/guition-media.png b/docs/images/guition-media.png new file mode 100644 index 0000000000000000000000000000000000000000..2ce69389207bc3cdb5693f64ac16d2fdf098ed2c GIT binary patch literal 27604 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 literal 0 HcmV?d00001 diff --git a/guition-4848s040.yaml b/guition-4848s040.yaml index 97d453e..14653a5 100644 --- a/guition-4848s040.yaml +++ b/guition-4848s040.yaml @@ -2,7 +2,7 @@ # Source profile for packages/guition.yaml (tools/generate_packages.py); see docs/GUITION.md. # A screen gets its tiles from the ESP Screen Manager add-on while it runs. The CYD is its own profile. substitutions: - SCREEN_FIRMWARE_VERSION: "0.2.63" + SCREEN_FIRMWARE_VERSION: "0.2.64" # 0: no drift limit; LVGL decides, releasing inside the tile is a tap, leaving it is not # (like iOS). The CYD keeps a limit because its resistive panel jumps. TOUCH_MOVE_LIMIT_PX: "0" diff --git a/home-like-2432s028.yaml b/home-like-2432s028.yaml index aed7c6b..97e5963 100644 --- a/home-like-2432s028.yaml +++ b/home-like-2432s028.yaml @@ -17,7 +17,7 @@ ############################################################ substitutions: - SCREEN_FIRMWARE_VERSION: "0.2.63" + SCREEN_FIRMWARE_VERSION: "0.2.64" # A tap survives a finger that drifts up to this far (320 px over 58 mm: 1 cm); further is a swipe. TOUCH_MOVE_LIMIT_PX: "56" # Shortest contact that counts as a tap; a resistive panel bounces, a capacitive one does not. diff --git a/packages/cyd.yaml b/packages/cyd.yaml index 37b5ac5..210e469 100644 --- a/packages/cyd.yaml +++ b/packages/cyd.yaml @@ -18,7 +18,7 @@ ############################################################ substitutions: - SCREEN_FIRMWARE_VERSION: "0.2.63" + SCREEN_FIRMWARE_VERSION: "0.2.64" # A tap survives a finger that drifts up to this far (320 px over 58 mm: 1 cm); further is a swipe. TOUCH_MOVE_LIMIT_PX: "56" # Shortest contact that counts as a tap; a resistive panel bounces, a capacitive one does not. diff --git a/packages/guition.yaml b/packages/guition.yaml index 624c283..6e309fc 100644 --- a/packages/guition.yaml +++ b/packages/guition.yaml @@ -3,7 +3,7 @@ # Source profile for packages/guition.yaml (tools/generate_packages.py); see docs/GUITION.md. # A screen gets its tiles from the ESP Screen Manager add-on while it runs. The CYD is its own profile. substitutions: - SCREEN_FIRMWARE_VERSION: "0.2.63" + SCREEN_FIRMWARE_VERSION: "0.2.64" # 0: no drift limit; LVGL decides, releasing inside the tile is a tap, leaving it is not # (like iOS). The CYD keeps a limit because its resistive panel jumps. TOUCH_MOVE_LIMIT_PX: "0" diff --git a/screen_manager/CHANGELOG.md b/screen_manager/CHANGELOG.md index 93b5585..1350aa8 100644 --- a/screen_manager/CHANGELOG.md +++ b/screen_manager/CHANGELOG.md @@ -1,3 +1,14 @@ +## 0.2.77 (firmware 0.2.64) + +A media card like a phone's "now playing", with the album cover on a Guition. + +- **The media card is new.** Tap a media player's tile and the card shows the album cover, the title, the artist and the album, a progress bar that runs while the track plays with the elapsed and total time at its ends, three round keys (previous, play or pause on the blue key, next) and a volume row: a mute key, a wide slider with a round knob, and the percentage. The keys the player does not offer are faded, the mute key and the slider follow what Home Assistant reports (a muted player shows a grey fill and *Muted*), and a player that is off shows one power key. A stream without a length shows no bar and no times. It works in the light and the dark look. +- **The album cover** comes the way camera images do (app 0.2.66): the screen asks ESP Screen Manager, the app fetches the picture from Home Assistant with its own access, makes it exactly the size the card asks for with the corners already rounded over the card's colour, and serves it on port 8098. A Guition loads it once and keeps it until the picture changes, the card closes or the page turns. The CYD has no memory for pictures and shows the player's icon in the cover's place, as it does when a player has no picture (a radio station, a player that is off). +- **A media tile over the whole page** (size *Full page*) is the same card under the tile's head: the cover at the left, the track, the bar and the keys beside it, the volume row along the bottom. The keys and the slider work on the tile; holding the tile still opens the card. +- **The card's clock runs on the screen.** Home Assistant reports where a track was and when; the bar and the elapsed time run on from there every second without any traffic, and stand still while the track is paused. +- Claude in Home Assistant and the editor need nothing new: a `media_player` tile is the same tile, with the new card behind it. +- Needs firmware 0.2.64 for the new card; the app serves covers only to a Guition on that firmware. Older firmware keeps the old card. Includes everything from 0.2.76. + ## 0.2.76 (firmware 0.2.63) The CYD in the editor shows the whole tile again. diff --git a/screen_manager/app/camera_feed.py b/screen_manager/app/camera_feed.py index 93ec071..6928709 100644 --- a/screen_manager/app/camera_feed.py +++ b/screen_manager/app/camera_feed.py @@ -23,6 +23,14 @@ LOG = logging.getLogger(__name__) DOMAINS = ('camera', 'image') MIN_FIRMWARE = (0, 2, 57) +# Album covers on the media card (app 0.2.77, firmware 0.2.64): the same port serves a media player's picture, square, +# at the size the screen asks for, with the rounded corners baked in over the colour the screen names (the card's +# page or the tile's own colour), so the screen draws it as it is. A cover is fetched when the screen loads its link +# and again only when Home Assistant's picture changes; the screen asks for a new link then. +COVER_DOMAINS = ('media_player',) +COVER_MIN_FIRMWARE = (0, 2, 64) +COVER_SIZES = (48, 320) # the smallest and largest cover a screen may ask for, in pixels +COVER_RADIUS_SHARE = 12 # the corner is a twelfth of the size, at least 4 px (media_card.h radius_for) PORT = 8098 # A camera nobody loaded a picture of for this long is forgotten, its last snapshot with it. WATCH_SECONDS = 30 @@ -60,6 +68,30 @@ def can_show(screen): return bool(screen) and screen.get('board') in BOXES and version(screen.get('firmware')) >= MIN_FIRMWARE +def cover_supported(entity): + """True for a media player entity id: its cover can be served.""" + return (isinstance(entity, str) and len(entity) <= 120 and re.fullmatch(r'[a-z0-9_]+\.[a-z0-9_]+', entity) is not None + and entity.split('.')[0] in COVER_DOMAINS) + + +def can_show_cover(screen): + """A paired Guition with firmware that draws the media card's cover.""" + return bool(screen) and screen.get('board') in BOXES and version(screen.get('firmware')) >= COVER_MIN_FIRMWARE + + +def cover_request(request): + """(size, background) a screen asked for, or None when the request is not a cover request the app can serve: + `size` in pixels within COVER_SIZES, `bg` six hex digits of the colour behind the corners.""" + try: + size = int(request.get('size')) + except (TypeError, ValueError): + return None + background = request.get('bg') + if not COVER_SIZES[0] <= size <= COVER_SIZES[1] or not isinstance(background, str) or not re.fullmatch(r'[0-9A-Fa-f]{6}', background): + return None + return size, int(background, 16) + + def fit(size, box): """The largest size with the proportions of `size` that fits `box`, at least one pixel each way.""" width, height = size @@ -90,12 +122,46 @@ def encode(raw, box): return out.getvalue() +def encode_cover(raw, size, background): + """A media player's picture as a square 24-bit BMP of `size` pixels with rounded corners, the corners filled with + `background` (0xRRGGBB): what the screen draws on its card without any work of its own. A picture that is not + square is cut to its middle.""" + from PIL import Image, ImageDraw, ImageOps + with Image.open(io.BytesIO(raw)) as source: + source.draft('RGB', (size, size)) + image = ImageOps.exif_transpose(source) + if image.mode in ('RGBA', 'LA', 'P', 'PA'): + image = image.convert('RGBA') + ground = Image.new('RGB', image.size, tuple((background >> shift) & 0xFF for shift in (16, 8, 0))) + ground.paste(image, mask=image.getchannel('A')) + image = ground + elif image.mode != 'RGB': + image = image.convert('RGB') + width, height = image.size + side = min(width, height) + if width != height: + left, top = (width - side) // 2, (height - side) // 2 + image = image.crop((left, top, left + side, top + side)) + if image.size != (size, size): + image = image.resize((size, size), Image.Resampling.LANCZOS) + radius = max(4, size // COVER_RADIUS_SHARE) + mask = Image.new('L', (size, size), 0) + ImageDraw.Draw(mask).rounded_rectangle((0, 0, size - 1, size - 1), radius=radius, fill=255) + ground = Image.new('RGB', (size, size), tuple((background >> shift) & 0xFF for shift in (16, 8, 0))) + ground.paste(image, mask=mask) + out = io.BytesIO() + ground.save(out, 'BMP') + return out.getvalue() + + class Watch: - """One camera: its last snapshot, the sizes made of it and the fetch on its way.""" + """One camera or media player: its last picture, the sizes made of it and the fetch on its way. For a media + player `picture` is the address the raw picture came from, so a changed picture is fetched again.""" def __init__(self, now): self.used = now self.raw, self.digest = None, '' + self.picture, self.fetching = None, None self.frames = {} self.failures = 0 self.retry_at = 0.0 @@ -103,18 +169,22 @@ class Watch: class Link: - __slots__ = ('entity', 'box', 'still', 'etag', 'used', 'lifetime') + __slots__ = ('entity', 'box', 'still', 'etag', 'used', 'lifetime', 'cover') - def __init__(self, entity, box, now, still=None): + def __init__(self, entity, box, now, still=None, cover=None): self.entity, self.box, self.used = entity, box, now self.still = still + self.cover = cover # (size, background) of a media player's cover, else None self.etag = f'"{hashlib.sha1(still).hexdigest()[:16]}"' if still else '' self.lifetime = STILL_SECONDS if still else LINK_SECONDS class CameraFeed: - def __init__(self, fetch, clock=time.monotonic): + def __init__(self, fetch, clock=time.monotonic, fetch_cover=None, picture=None): + """`fetch(entity)` gives a camera's snapshot; `fetch_cover(entity)` a media player's picture and + `picture(entity)` the address that picture has in its state right now ('' without one).""" self.fetch, self.clock = fetch, clock + self.fetch_cover, self.picture = fetch_cover, picture self.watches, self.links = {}, {} # ----- fetching ----- @@ -194,6 +264,61 @@ class CameraFeed: cached = watch.frames[box] = (digest, image) return f'"{digest[:16]}-{box[0]}x{box[1]}"', cached[1] + # ----- covers ----- + # A media player's picture is fetched when a screen loads its cover link and Home Assistant's picture is another + # one than the last fetched (or none was fetched yet): a cover never changes on its own between two loads, and the + # screen loads again only when the state's picture mark changed. So a load waits for the picture of this moment. + async def fetch_cover_one(self, entity, watch, picture): + try: + raw = await asyncio.wait_for(self.fetch_cover(entity), FETCH_SECONDS) + if not raw: + raise ValueError('empty picture') + digest = hashlib.sha1(raw).hexdigest() + if digest != watch.digest: + watch.raw, watch.digest, watch.frames = raw, digest, {} + watch.picture = picture + if watch.failures: + LOG.info('The cover of %s comes again', entity) + watch.failures = 0 + except asyncio.CancelledError: + raise + except Exception as error: + watch.failures += 1 + if watch.failures in (1, 30): + LOG.info('No cover from %s (%s)', entity, type(error).__name__) + + async def cover(self, entity, size, background, wait=FIRST_FRAME_SECONDS): + """(etag, BMP) of the player's cover at `size` with `background` behind its corners, or None when the player + shows no picture or it cannot be fetched.""" + if self.fetch_cover is None or self.picture is None: + return None + picture = self.picture(entity) + if not picture: + return None + watch = self.watch(entity) + if watch.picture != picture or watch.raw is None: + if watch.task is None or watch.task.done() or watch.fetching != picture: + if watch.task is not None and not watch.task.done(): + watch.task.cancel() + watch.fetching = picture + watch.task = asyncio.ensure_future(self.fetch_cover_one(entity, watch, picture)) + try: + await asyncio.wait_for(asyncio.shield(watch.task), wait) + except asyncio.TimeoutError: + return None + if watch.picture != picture or watch.raw is None: + return None + key = ('cover', size, background) + cached = watch.frames.get(key) + if cached is None or cached[0] != watch.digest: + try: + image = await asyncio.get_running_loop().run_in_executor(None, encode_cover, watch.raw, size, background) + except Exception as error: + LOG.info('The cover of %s cannot be read (%s)', entity, type(error).__name__) + return None + cached = watch.frames[key] = (watch.digest, image) + return f'"{watch.digest[:16]}-c{size}-{background:06X}"', cached[1] + # ----- links ----- def prune(self): now = self.clock() @@ -202,11 +327,12 @@ class CameraFeed: while len(self.links) >= MAX_LINKS: del self.links[min(self.links, key=lambda token: self.links[token].used)] - def link(self, entity, box, still=None): - """A new random token for one camera at one size; `still` makes it one fixed image (an alert's).""" + def link(self, entity, box, still=None, cover=None): + """A new random token for one camera at one size; `still` makes it one fixed image (an alert's), `cover` + (size, background) a media player's cover.""" self.prune() token = secrets.token_urlsafe(18) - self.links[token] = Link(entity, box, self.clock(), still) + self.links[token] = Link(entity, box, self.clock(), still, cover) return token async def serve(self, token, etag=None): @@ -219,7 +345,7 @@ class CameraFeed: link.used = now if link.still: return (304, None, link.etag) if etag == link.etag else (200, link.still, link.etag) - found = await self.frame(link.entity, link.box) + found = await self.cover(link.entity, *link.cover) if link.cover else await self.frame(link.entity, link.box) if found is None: return 503, None, '' tag, image = found diff --git a/screen_manager/app/core.py b/screen_manager/app/core.py index 8628737..0edcea6 100644 --- a/screen_manager/app/core.py +++ b/screen_manager/app/core.py @@ -22,6 +22,8 @@ NEW_DOMAINS = frozenset('sun timer person screen'.split()) # A camera or an image entity opens full screen on a Guition with firmware 0.2.57+ (camera_feed.py). CAMERA_DOMAINS = frozenset(('camera', 'image')) CAMERA_MIN_FIRMWARE = (0, 2, 57) +# The media card with its cover (app 0.2.77): firmware from here draws it and asks for the cover. +COVER_MIN_FIRMWARE = (0, 2, 64) # Forty-eight tiles (one per slot), a tile over the whole page and the screen.page tile (firmware 0.2.62+). MAX_TILES = 48 LEGACY_MAX_TILES = 20 @@ -30,7 +32,7 @@ WEEKDAYS = ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su'] REPO = 'https://github.com/MaxGramser/homeassistant_espscreen' REFS = {'cyd': 'main', 'guition': 'main'} # Firmware shipped with this app release; screens below it get an update offer. -FIRMWARE_VERSION = '0.2.63' +FIRMWARE_VERSION = '0.2.64' # The Auto standby switch a screen offers Home Assistant automations. AUTO_STANDBY_MIN_FIRMWARE = '0.2.41' # The settings page the screen opens itself, and the screen.settings tile that opens it. @@ -961,6 +963,36 @@ def vacuum_extras(tile, states, device): result['room'] = short(room, 32) return result or None +def media_extras(attrs): + """The media card (app 0.2.77, firmware 0.2.64+): the artist and the album, the track's length and where it was + when Home Assistant last said so (seconds; that moment as an epoch), and a short mark of the cover picture. The + mark changes with the picture and says nothing else: the screen asks the app for the picture itself.""" + result = {} + for key, name in (('artist', 'media_artist'), ('album', 'media_album_name')): + value = attrs.get(name) + if isinstance(value, str) and value.strip(): + result[key] = short(value.strip(), 80) + for key, name in (('dur', 'media_duration'), ('pos', 'media_position')): + value = attrs.get(name) + if isinstance(value, (int, float)) and not isinstance(value, bool) and math.isfinite(value) and 0 <= value <= 10_000_000: + if key == 'dur' and value <= 0: + continue + result[key] = int(value) + moment = attrs.get('media_position_updated_at') + if isinstance(moment, str) and moment: + try: + parsed = datetime.fromisoformat(moment.replace('Z', '+00:00')) + if parsed.tzinfo is None: + parsed = parsed.replace(tzinfo=timezone.utc) + result['at'] = int(parsed.timestamp()) + except ValueError: + pass + picture = attrs.get('entity_picture') or attrs.get('entity_picture_local') + if isinstance(picture, str) and picture: + result['pic'] = hashlib.sha1(picture.encode()).hexdigest()[:10] + return result or None + + def extras(tile, states, forecast=None, tz=None, hourly=None, now=None, device=None): """Small, pre-computed values the firmware cannot derive itself (time zones, forecasts, a vacuum's device).""" domain = tile['entity'].split('.')[0] @@ -969,6 +1001,8 @@ def extras(tile, states, forecast=None, tz=None, hourly=None, now=None, device=N return vacuum_extras(tile, states, device) if domain == 'cover': return device_power(attrs, cover_related(tile['entity'], device, states), states) or None + if domain == 'media_player': + return media_extras(attrs) if domain == 'weather' and (forecast or hourly): result = {} days = [] diff --git a/screen_manager/app/server.py b/screen_manager/app/server.py index 61ecf47..9309283 100644 --- a/screen_manager/app/server.py +++ b/screen_manager/app/server.py @@ -392,6 +392,36 @@ class HomeAssistant: raise ValueError('image too large') return bytes(raw) + def media_picture(self, entity): + """The address of a media player's cover as its state carries it right now, or '' without one.""" + attrs = self.states.get(entity, {}).get('attributes', {}) + picture = attrs.get('entity_picture') or attrs.get('entity_picture_local') + return picture if isinstance(picture, str) and picture else '' + + async def media_image(self, entity): + """The cover of a media player (app 0.2.77), fetched where its state points: Home Assistant's own proxy + with this app's token (`/api/media_player_proxy/...`), or a picture on the internet as it is.""" + picture = self.media_picture(entity) + if not picture: + raise ValueError('no picture') + root = self.base[:-4] if self.base.endswith('/api') else self.base + if picture.startswith('/'): + url, headers = f'{root}{picture}', {'Authorization': 'Bearer ' + self.token} + elif picture.startswith(('http://', 'https://')): + url, headers = picture, {} + else: + raise ValueError('unknown picture address') + async with self.session.get(url, headers=headers, timeout=ClientTimeout(total=camera_feed.FETCH_SECONDS)) as response: + response.raise_for_status() + if (response.content_length or 0) > camera_feed.MAX_SNAPSHOT_BYTES: + raise ValueError('picture too large') + raw = bytearray() + async for chunk in response.content.iter_chunked(65536): + raw += chunk + if len(raw) > camera_feed.MAX_SNAPSHOT_BYTES: + raise ValueError('picture too large') + return bytes(raw) + async def fire(self, event_type, data): """One Home Assistant event of our own, such as the answer to a tile event.""" await self.request('fire_event', event_type=event_type, event_data=data) @@ -502,7 +532,9 @@ class Manager: self.card_histories, self.card_history_fetches = {}, {} # Camera images (firmware 0.2.57+): the feed behind the camera port, and the cameras of recent alerts # (entity -> monotonic time) that a screen may open full screen without a tile. - self.camera = camera_feed.CameraFeed(lambda entity: self.ha.camera_image(entity)) + self.camera = camera_feed.CameraFeed(lambda entity: self.ha.camera_image(entity), + fetch_cover=lambda entity: self.ha.media_image(entity), + picture=lambda entity: self.ha.media_picture(entity)) self.alert_cameras = {} if self.path.exists(): raw = json.loads(self.path.read_text()) @@ -1357,14 +1389,31 @@ class Manager: inbox = self.aliases.get(request.get('inbox'), request.get('inbox')) entity = request.get('entity') screen = self.screen(inbox) if isinstance(inbox, str) else None - if not camera_feed.supported(entity) or not camera_feed.can_show(screen) or not screen.get('online'): + # A media player's cover (app 0.2.77, firmware 0.2.64+) comes the same way, at the size the card asks for. + cover = camera_feed.cover_request(request) if camera_feed.cover_supported(entity) else None + if cover: + if not camera_feed.can_show_cover(screen) or not screen.get('online'): + return + elif not camera_feed.supported(entity) or not camera_feed.can_show(screen) or not screen.get('online'): return action = self.transport(inbox, screen) if not action or not self.camera_allowed(inbox, entity): return - message = await self.camera_message(entity, 'full', screen['board']) + message = await self.cover_message(entity, *cover) if cover else await self.camera_message(entity, 'full', screen['board']) await self.ha.send(inbox, message, action) - LOG.info('Camera %s on %s%s', entity, screen['name'], '' if message['u'] else ': no image') + LOG.info('%s %s on %s%s', 'Cover of' if cover else 'Camera', entity, screen['name'], '' if message['u'] else ': no image') + + async def cover_message(self, entity, size, background): + """The screen message with a link to a media player's cover at `size` with `background` behind the corners, + or an empty link when the player shows no picture (the card keeps its placeholder).""" + url = '' + base = await camera_feed.base_url(self.ha.request) + if base: + token = self.camera.link(entity, (size, size), cover=(size, background)) if await self.camera.cover(entity, size, background) else None + url = f'{base}/camera/{token}.bmp' if token else '' + else: + LOG.warning('Covers: no address for this app on the LAN; set SCREEN_CAMERA_URL') + return {'v': 1, 'op': 'camera', 't': 'cover', 'e': entity, 'u': url} async def alert_images(self, camera, screens): """The picture of an alert's camera at that moment, on every screen that draws it.""" diff --git a/screen_manager/config.yaml b/screen_manager/config.yaml index 1e6a601..773e100 100644 --- a/screen_manager/config.yaml +++ b/screen_manager/config.yaml @@ -1,5 +1,5 @@ name: ESP Screen Manager -version: "0.2.76" +version: "0.2.77" slug: esp_screen_manager description: Choose tiles for your CYD and Guition touchscreen, without reflashing. url: https://github.com/MaxGramser/homeassistant_espscreen diff --git a/tests/test_camera_view.cpp b/tests/test_camera_view.cpp index 2dbf12f..d66bf70 100644 --- a/tests/test_camera_view.cpp +++ b/tests/test_camera_view.cpp @@ -61,5 +61,39 @@ int main() { feed.start(0); feed.finish(10, true); assert(!feed.should_load(REFRESH_MS - 1) && feed.should_load(REFRESH_MS + 1)); + + // An album cover (firmware 0.2.64+) loads once per link: it stays on screen, never refreshed on a clock. + Feed cover; + cover.open("media_player.office", true); + assert(cover.once && cover.should_ask(0)); + cover.ask(0); + cover.link("http://h/camera/cover.bmp"); + assert(cover.should_load(100)); + cover.start(100); + cover.finish(400, true); + assert(cover.loaded && cover.shown && !cover.should_load(400 + GAP_MS) && !cover.should_load(400 + 10 * REFRESH_MS) && !cover.should_ask(400 + ASK_AGAIN_MS)); + // A failed load is tried again after the gap; three failures forget the link so the card asks for a new one. + cover.link("http://h/camera/cover2.bmp"); + assert(!cover.loaded && cover.should_load(1000)); + cover.start(1000); cover.finish(1100, false); + assert(!cover.should_load(1100 + GAP_MS - 1) && cover.should_load(1100 + GAP_MS)); + cover.start(2000); cover.finish(2100, false); + cover.start(3000); cover.finish(3100, false); + assert(cover.url.empty() && cover.should_ask(3100)); + // A new link (a new picture in Home Assistant) loads again, once. + cover.ask(3100); + cover.link("http://h/camera/cover3.bmp"); + cover.start(3200); cover.finish(3500, true); + assert(cover.loaded && !cover.should_load(3500 + 10 * REFRESH_MS)); + // A player without a picture (or an app from before covers) answers an empty link: asked once, then left alone. + Feed bare; + bare.open("media_player.radio", true); + bare.ask(0); + bare.link(""); + assert(bare.empty && !bare.should_ask(ASK_AGAIN_MS) && !bare.should_ask(100 * ASK_AGAIN_MS) && !bare.should_load(ASK_AGAIN_MS)); + // A camera feed keeps its clock: open() without the flag. + Feed live; + live.open("camera.front_door"); + assert(!live.once); return 0; } diff --git a/tests/test_media_card.cpp b/tests/test_media_card.cpp new file mode 100644 index 0000000..0d9b2e0 --- /dev/null +++ b/tests/test_media_card.cpp @@ -0,0 +1,103 @@ +// clang++ -std=c++17 -Wall -Wextra -Werror -I. tests/test_media_card.cpp -o /tmp/test_media_card && /tmp/test_media_card +#include "../components/smart_display/media_card.h" +#include +#include + +using namespace media_card; + +static bool inside(const Rect &r, int width, int height) { return r.x >= 0 && r.y >= 0 && r.right() <= width && r.bottom() <= height; } +static bool apart(const Rect &a, const Rect &b) { return a.right() <= b.x || b.right() <= a.x || a.bottom() <= b.y || b.bottom() <= a.y; } +static bool above(const Rect &a, const Rect &b) { return a.bottom() <= b.y; } + +// Every part inside the area, nothing over anything else, the keys in one row and the volume row at the bottom. +static void sound(const Layout &l, int width, int height) { + const Rect *parts[] = {&l.art, &l.title, &l.bar, &l.prev, &l.play, &l.next, &l.mute, &l.volume, &l.percent}; + for (const Rect *r : parts) assert(r->w > 0 && r->h > 0 && inside(*r, width, height)); + if (l.artist) assert(l.artist_line.h > 0 && inside(l.artist_line, width, height)); + if (l.times) assert(l.elapsed.h > 0 && l.total.h > 0 && inside(l.elapsed, width, height) && inside(l.total, width, height)); + // The keys share a centre line, the play key is the biggest, previous and next are alike. + assert(l.prev.cy() == l.play.cy() && l.next.cy() == l.play.cy()); + assert(l.play.w > l.prev.w && l.prev.w == l.next.w && l.prev.w == l.prev.h); + assert(l.prev.right() < l.play.x && l.play.right() < l.next.x); + // The volume row runs along the bottom under everything else: the mute key, the slider, the percentage. + assert(l.mute.right() < l.volume.x && l.volume.right() < l.percent.x); + for (const Rect *r : {&l.art, &l.title, &l.bar, &l.prev, &l.play, &l.next}) assert(above(*r, l.volume) && above(*r, l.mute)); + // Nothing overlaps. + const Rect *rects[] = {&l.art, &l.title, &l.artist_line, &l.bar, &l.elapsed, &l.total, &l.prev, &l.play, &l.next, &l.mute, &l.volume, &l.percent}; + for (const Rect *a : rects) for (const Rect *b : rects) if (a != b && a->w && b->w) assert(apart(*a, *b)); + // The art is square and its corner follows its size. + assert(l.art.w == l.art.h && l.art_radius == radius_for(l.art.w)); +} + +int main() { + // The Guition's card: 480 wide under its top bar, a tall area, so everything stacks under the art. + { + Metrics m; Layout l = layout(m, 480, 396); + sound(l, 480, 396); + assert(!l.wide && l.times && l.artist); + assert(l.art.w >= 160 && l.art.cx() == 240); + assert(above(l.art, l.title) && above(l.title, l.artist_line) && above(l.artist_line, l.bar) && above(l.bar, l.play)); + assert(l.play.cx() == 240 && l.title.x == 24 && l.title.w == 432); + // The times sit at the ends of the bar, on its line. + assert(l.elapsed.cy() == l.bar.cy() && l.total.cy() == l.bar.cy() && l.elapsed.right() <= l.bar.x && l.bar.right() <= l.total.x); + assert(l.elapsed.x == l.title.x && l.total.right() == l.title.right()); + // The keys are big enough for a thumb. + assert(l.play.w >= 64 && l.prev.w >= 52); + printf("guition card: art %d at %d,%d keys y=%d volume y=%d\n", l.art.w, l.art.x, l.art.y, l.play.y, l.volume.y); + } + // The CYD's card: 320 wide, 192 tall under its bar: the art at the left, the column beside it, times included. + { + Metrics m; m.large = false; m.title_h = 21; m.artist_h = 17; m.small_h = 13; + Layout l = layout(m, 320, 192); + sound(l, 320, 192); + assert(l.wide && l.times && l.artist && l.art.w == 120); + assert(l.title.x > l.art.right() && l.title.y >= l.art.y && l.play.bottom() <= l.art.bottom()); + assert(l.title.right() == 310 && l.play.cx() == l.title.cx()); + printf("cyd card: art %d column x=%d w=%d keys y=%d\n", l.art.w, l.title.x, l.title.w, l.play.y); + } + // A Guition tile over the whole page under its head: wide, everything fits, the keys never wider than the column. + { + Metrics m; Layout l = layout(m, 448, 236); + sound(l, 448, 236); + assert(l.wide && l.times && l.artist && l.art.w >= 180); + // The head of a real tile leaves 202 px: the artist line still fits beside a smaller cover. + Layout r = layout(m, 448, 202); + sound(r, 448, 202); + assert(r.artist && r.times && r.art.w >= 150); + assert(l.prev.x >= l.title.x && l.next.right() <= l.title.right()); + printf("guition full: art %d column w=%d gap=%d\n", l.art.w, l.title.w, l.play.x - l.prev.right()); + } + // A CYD tile over the whole page under its head: little room, so the artist line goes and the art shrinks. + { + Metrics m; m.large = false; m.title_h = 21; m.artist_h = 17; m.small_h = 13; + Layout l = layout(m, 302, 108); + sound(l, 302, 108); + assert(l.wide && !l.artist && l.art.w < 120 && l.art.w >= 60); + assert(l.play.bottom() <= 108 - 22 - 6 && l.bar.h == 4); + printf("cyd full: art %d keys y=%d bottom=%d\n", l.art.w, l.play.y, l.play.bottom()); + } + // A very short tall area still holds every part (times gone, a small cover). + { + Metrics m; Layout l = layout(m, 300, 300); + sound(l, 300, 300); + assert(!l.wide); + } + // Progress: the position runs on while playing, stands still when paused, never beyond the track. + assert(progress(0, 0, 0, true, 0) == -1); + assert(progress(60, 1000, 1000, true, 240) == 250); + assert(progress(60, 1000, 1060, true, 240) == 500); + assert(progress(60, 1000, 1060, false, 240) == 250); + assert(progress(60, 1000, 9000, true, 240) == 1000); + assert(progress(60, 0, 9000, true, 240) == 250); // no report time: the position as it was + assert(elapsed_seconds(60, 1000, 1030, true, 240) == 90 && elapsed_seconds(300, 0, 0, false, 240) == 240); + // Times as every player writes them. + assert(clock_text(0) == "0:00" && clock_text(187) == "3:07" && clock_text(3600) == "1:00:00" && clock_text(3765) == "1:02:45"); + // The second line and the idle words. + assert(subtitle("KATZROAR", "Invocation") == "KATZROAR · Invocation"); + assert(subtitle("KATZROAR", "") == "KATZROAR" && subtitle("", "Invocation") == "Invocation" && subtitle("", "").empty()); + assert(std::string(idle_text("off")) == "Off" && std::string(idle_text("idle")) == "Not playing" && std::string(idle_text("standby")) == "Standby"); + assert(playing("playing") && playing("buffering") && !playing("paused")); + assert(has_track("paused") && !has_track("idle") && !has_track("off")); + printf("test_media_card: ok\n"); + return 0; +} diff --git a/tests/test_media_card.py b/tests/test_media_card.py new file mode 100644 index 0000000..ff4cf16 --- /dev/null +++ b/tests/test_media_card.py @@ -0,0 +1,268 @@ +"""The media card (app 0.2.77, firmware 0.2.64): what the app pre-computes for it, and the album cover the app serves +like a camera image (camera_feed), at the size the card asks for, with the corners rounded over the colour behind them.""" +import asyncio +import importlib.util +import io +from pathlib import Path +import re +import sys +import unittest + +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT / 'screen_manager/app')) +import camera_feed # noqa: E402 +from core import COVER_MIN_FIRMWARE, extras, media_extras, state_message # noqa: E402 + +HAS_PIL = importlib.util.find_spec('PIL') is not None +HAS_AIOHTTP = importlib.util.find_spec('aiohttp') is not None +if HAS_AIOHTTP: + from server import Manager + +TILES = (ROOT / 'components/smart_display/runtime_tiles.h').read_text() +MODEL = (ROOT / 'components/smart_display/runtime_model.h').read_text() +CARD = (ROOT / 'components/smart_display/media_card.h').read_text() +SONOS = {'friendly_name': 'Office', 'media_title': 'Woman at the Loom', 'media_artist': 'KATZROAR', 'media_album_name': 'Invocation', + 'media_duration': 270, 'media_position': 0, 'media_position_updated_at': '2026-09-18T10:09:49.068667+00:00', + 'volume_level': 0.14, 'is_volume_muted': False, 'supported_features': 8321599, + 'entity_picture': '/api/media_player_proxy/media_player.office?token=5674b25e&cache=556b49fd9c3e8ccd'} + + +def picture(size=(640, 640), mode='RGB', fmt='JPEG'): + from PIL import Image + out = io.BytesIO() + Image.new(mode, size, (200, 30, 90) if mode == 'RGB' else None).save(out, fmt) + return out.getvalue() + + +class Extras(unittest.TestCase): + def test_the_card_gets_artist_album_length_position_and_a_picture_mark(self): + extra = media_extras(SONOS) + self.assertEqual(extra['artist'], 'KATZROAR') + self.assertEqual(extra['album'], 'Invocation') + self.assertEqual(extra['dur'], 270) + self.assertEqual(extra['pos'], 0) + self.assertEqual(extra['at'], 1789726189) # 2026-09-18T10:09:49Z + self.assertTrue(re.fullmatch(r'[0-9a-f]{10}', extra['pic'])) + # The mark follows the picture and nothing else: a new cache token is a new picture. + other = media_extras({**SONOS, 'entity_picture': SONOS['entity_picture'].replace('556b49fd9c3e8ccd', '1')}) + self.assertNotEqual(other['pic'], extra['pic']) + self.assertEqual(media_extras({**SONOS, 'volume_level': 0.5})['pic'], extra['pic']) + + def test_a_player_without_a_track_gets_no_extras(self): + self.assertIsNone(media_extras({'friendly_name': 'Bedroom', 'supported_features': 8321599})) + self.assertIsNone(media_extras({'media_artist': None, 'media_duration': None, 'media_position_updated_at': None})) + # A stream: a title, no length, no picture. The card shows an empty bar and no times. + self.assertIsNone(media_extras({'media_title': 'NPO Radio 2', 'media_content_type': 'channel'})) + + def test_odd_values_stay_away(self): + extra = media_extras({**SONOS, 'media_duration': -5, 'media_position': float('nan'), 'media_position_updated_at': 'yesterday', + 'media_artist': ' ', 'entity_picture': 42}) + self.assertNotIn('dur', extra) + self.assertNotIn('pos', extra) + self.assertNotIn('at', extra) + self.assertNotIn('artist', extra) + self.assertNotIn('pic', extra) + self.assertEqual(extra['album'], 'Invocation') + # Long names are cut like every text on a screen; a picture the state names as local counts too. + extra = media_extras({'media_artist': 'x' * 200, 'entity_picture_local': '/api/media_player_proxy/a?token=b'}) + self.assertEqual(len(extra['artist']), 80) + self.assertIn('pic', extra) + + def test_the_state_message_carries_them_and_stays_small(self): + states = {'media_player.office': {'state': 'playing', 'attributes': SONOS}} + tile = {'entity': 'media_player.office', 'name': ''} + message = state_message(0, tile, states, extras(tile, states)) + self.assertEqual(message['x']['artist'], 'KATZROAR') + self.assertEqual(message['a']['media_title'], 'Woman at the Loom') + self.assertLess(len(str(message)), 700) + + +class Firmware(unittest.TestCase): + def test_the_firmware_reads_what_the_app_sends(self): + for key in ('extra["artist"]', 'extra["album"]', 'extra["pic"]', 'extra["dur"]', 'extra["pos"]', 'extra["at"]'): + self.assertIn(key, TILES, key) + for field in ('media_artist', 'media_album', 'media_picture', 'media_duration', 'media_position', 'media_position_at'): + self.assertIn(field, MODEL, field) + self.assertIn(field, MODEL[MODEL.index('bool empty() const'):], f'{field} counted in Extra::empty') + + def test_the_card_asks_for_a_cover_with_size_and_background(self): + self.assertIn('"size", "bg"', TILES) + self.assertIn('view != "cover"', TILES) + self.assertIn('if (view == "cover")', TILES) + # The keys of the card and of the tile over the whole page share one action table. + self.assertIn('inline void media_action(Tile &t,int cmd)', TILES) + self.assertIn('media_player.volume_mute', TILES) + # The cover goes before the camera loads into the same buffer, and comes back after. + self.assertIn('cover_release();\n if (camera_release_due) camera_release();', TILES) + + def test_the_layout_has_no_colour_of_its_own(self): + self.assertIsNone(re.search(r'0x[0-9A-Fa-f]{6}', CARD)) + self.assertNotIn('lv_', CARD) + + +class Covers(unittest.TestCase): + def test_a_media_player_may_ask_for_a_cover_and_a_camera_may_not(self): + self.assertTrue(camera_feed.cover_supported('media_player.office')) + self.assertFalse(camera_feed.cover_supported('camera.front_door')) + self.assertFalse(camera_feed.cover_supported('media_player.Office')) + self.assertFalse(camera_feed.supported('media_player.office')) + self.assertEqual(camera_feed.COVER_MIN_FIRMWARE, COVER_MIN_FIRMWARE) + self.assertTrue(camera_feed.can_show_cover({'board': 'guition', 'firmware': '0.2.64'})) + self.assertFalse(camera_feed.can_show_cover({'board': 'guition', 'firmware': '0.2.63'})) + self.assertFalse(camera_feed.can_show_cover({'board': 'cyd', 'firmware': '0.2.64'})) + + def test_the_request_names_a_size_and_a_background(self): + self.assertEqual(camera_feed.cover_request({'size': '160', 'bg': 'E7E7E7'}), (160, 0xE7E7E7)) + self.assertEqual(camera_feed.cover_request({'size': 200, 'bg': '1a1a1a'}), (200, 0x1A1A1A)) + for bad in ({'size': '9999', 'bg': 'FFFFFF'}, {'size': '10', 'bg': 'FFFFFF'}, {'size': '160', 'bg': 'white'}, + {'size': '160'}, {'bg': 'FFFFFF'}, {'size': 'x', 'bg': 'FFFFFF'}): + self.assertIsNone(camera_feed.cover_request(bad), bad) + + @unittest.skipUnless(HAS_PIL, 'Pillow') + def test_the_cover_is_square_at_the_size_asked_with_rounded_corners_over_the_background(self): + from PIL import Image + out = camera_feed.encode_cover(picture((640, 640), fmt='PNG'), 160, 0x1A1A1A) + with Image.open(io.BytesIO(out)) as image: + self.assertEqual((image.format, image.size, image.mode), ('BMP', (160, 160), 'RGB')) + self.assertEqual(image.getpixel((0, 0)), (26, 26, 26)) # the corner: the background + self.assertEqual(image.getpixel((80, 80)), (200, 30, 90)) # the middle: the picture + self.assertEqual(image.getpixel((0, 80)), (200, 30, 90)) # the edge between the corners: the picture + # A wide picture is cut to its middle; a PNG with transparency lands on the background. + with Image.open(io.BytesIO(camera_feed.encode_cover(picture((900, 300)), 48, 0xFFFFFF))) as image: + self.assertEqual(image.size, (48, 48)) + with Image.open(io.BytesIO(camera_feed.encode_cover(picture((100, 100), 'RGBA', 'PNG'), 48, 0x00FF00))) as image: + self.assertEqual(image.size, (48, 48)) + + @unittest.skipUnless(HAS_PIL, 'Pillow') + def test_a_cover_is_fetched_when_the_picture_changes_and_served_at_a_link(self): + pictures = {'media_player.office': '/api/media_player_proxy/media_player.office?token=a&cache=1'} + fetched = [] + + async def fetch_cover(entity): + fetched.append(pictures[entity]) + return picture((640, 640)) if 'cache=1' in pictures[entity] else picture((300, 300)) + + async def scenario(): + feed = camera_feed.CameraFeed(lambda entity: None, fetch_cover=fetch_cover, picture=lambda entity: pictures.get(entity, '')) + # No picture: no cover, nothing fetched. + self.assertIsNone(await feed.cover('media_player.bedroom', 160, 0)) + self.assertEqual(fetched, []) + # The first load fetches; the next load of the same picture serves what it has. + tag, image = await feed.cover('media_player.office', 160, 0xFFFFFF) + self.assertEqual(len(fetched), 1) + self.assertTrue(tag.endswith('-c160-FFFFFF"')) + again = await feed.cover('media_player.office', 160, 0xFFFFFF) + self.assertEqual(len(fetched), 1) + self.assertEqual(again, (tag, image)) + # Another size or background: the same picture, sized again. + other_tag, other = await feed.cover('media_player.office', 192, 0x1A1A1A) + self.assertEqual(len(fetched), 1) + self.assertNotEqual(other_tag, tag) + self.assertNotEqual(other, image) + # A new picture in Home Assistant: fetched again on the next load. + pictures['media_player.office'] = '/api/media_player_proxy/media_player.office?token=a&cache=2' + new_tag, _ = await feed.cover('media_player.office', 160, 0xFFFFFF) + self.assertEqual(len(fetched), 2) + self.assertNotEqual(new_tag, tag) + # The link: a screen loads it, and the link answers with the cover of this moment. + token = feed.link('media_player.office', (160, 160), cover=(160, 0xFFFFFF)) + status, body, etag = await feed.serve(token) + self.assertEqual((status, etag), (200, new_tag)) + self.assertEqual(body[:2], b'BM') + self.assertEqual((await feed.serve(token, etag))[0], 304) + # A player whose picture went away: no cover. + pictures['media_player.office'] = '' + self.assertIsNone(await feed.cover('media_player.office', 160, 0xFFFFFF)) + self.assertEqual((await feed.serve(token))[0], 503) + + asyncio.run(scenario()) + + @unittest.skipUnless(HAS_PIL, 'Pillow') + def test_a_failing_fetch_gives_no_cover(self): + async def failing(entity): + raise ConnectionError('gone') + + async def scenario(): + feed = camera_feed.CameraFeed(lambda entity: None, fetch_cover=failing, picture=lambda entity: '/api/x') + self.assertIsNone(await feed.cover('media_player.office', 160, 0)) + self.assertEqual(feed.watches['media_player.office'].failures, 1) + + asyncio.run(scenario()) + + +@unittest.skipUnless(HAS_AIOHTTP and HAS_PIL, 'aiohttp and Pillow') +class Answer(unittest.TestCase): + """The app's answer to a screen's request, through Manager.answer_camera with a Home Assistant stand-in.""" + + class HA: + online = True + + def __init__(self, firmware='0.2.64', guition=True): + self.registry = [{'entity_id': 'text.hall_tile_settings', 'platform': 'esphome', 'original_name': 'Tile settings', 'device_id': 'd1'}, + {'entity_id': 'sensor.hall_node', 'platform': 'esphome', 'original_name': 'Device name', 'device_id': 'd1'}, + {'entity_id': 'sensor.hall_fw', 'platform': 'esphome', 'original_name': 'Screen firmware', 'device_id': 'd1'}] + if guition: + self.registry.append({'entity_id': 'select.hall_type', 'platform': 'esphome', 'original_name': 'Guition screen type', 'device_id': 'd1'}) + self.devices, self.areas = [{'id': 'd1', 'name': 'Hall'}], [] + self.states = {'text.hall_tile_settings': {'state': 'Synced'}, 'sensor.hall_node': {'state': 'hall'}, 'sensor.hall_fw': {'state': firmware}, + 'media_player.office': {'state': 'playing', 'attributes': SONOS}, + 'media_player.radio': {'state': 'playing', 'attributes': {'media_title': 'Radio 2', 'supported_features': 8321599}}} + self.sent, self.responses, self.time_zone, self.changed = [], set(), None, asyncio.Event() + + async def send(self, inbox, message, action=None, respond=False): + self.sent.append((inbox, message)) + + async def request(self, kind, **data): + return {'adapters': [{'default': True, 'ipv4': [{'address': '192.168.1.5'}]}]} if kind == 'network' else {} + + def media_picture(self, entity): + attrs = self.states.get(entity, {}).get('attributes', {}) + return attrs.get('entity_picture') or '' + + async def media_image(self, entity): + return picture() + + def manager(self, ha): + import tempfile + manager = Manager(ha, Path(tempfile.mkdtemp()) / 'screens.json') + manager.save('text.hall_tile_settings', {'title': 'Hall', 'tiles': [{'entity': 'media_player.office', 'name': ''}, {'entity': 'media_player.radio', 'name': ''}]}) + return manager + + def test_a_guition_card_gets_a_link_a_stream_an_empty_one_and_a_stranger_nothing(self): + ha = self.HA() + manager = self.manager(ha) + + async def scenario(): + await manager.answer_camera({'inbox': 'text.hall_tile_settings', 'entity': 'media_player.office', 'size': '160', 'bg': 'E7E7E7'}) + self.assertEqual(len(ha.sent), 1) + message = ha.sent[0][1] + self.assertEqual((message['op'], message['t'], message['e']), ('camera', 'cover', 'media_player.office')) + self.assertTrue(message['u'].startswith('http://192.168.1.5:') and message['u'].endswith('.bmp')) + token = message['u'].rsplit('/', 1)[1][:-4] + status, body, _ = await manager.camera.serve(token) + self.assertEqual(status, 200) + from PIL import Image + with Image.open(io.BytesIO(body)) as image: + self.assertEqual(image.size, (160, 160)) + self.assertEqual(image.getpixel((0, 0)), (0xE7, 0xE7, 0xE7)) + # A stream without a picture: an empty link, so the card keeps its placeholder and stops asking. + await manager.answer_camera({'inbox': 'text.hall_tile_settings', 'entity': 'media_player.radio', 'size': '160', 'bg': 'E7E7E7'}) + self.assertEqual(ha.sent[1][1], {'v': 1, 'op': 'camera', 't': 'cover', 'e': 'media_player.radio', 'u': ''}) + # A player that is not on the screen's layout, a size out of range, a request without a size: no answer. + for request in ({'inbox': 'text.hall_tile_settings', 'entity': 'media_player.other', 'size': '160', 'bg': 'E7E7E7'}, + {'inbox': 'text.hall_tile_settings', 'entity': 'media_player.office', 'size': '2000', 'bg': 'E7E7E7'}, + {'inbox': 'text.hall_tile_settings', 'entity': 'media_player.office'}): + await manager.answer_camera(request) + self.assertEqual(len(ha.sent), 2) + + asyncio.run(scenario()) + + def test_older_firmware_and_a_cyd_get_no_cover(self): + for ha in (self.HA(firmware='0.2.63'), self.HA(guition=False)): + manager = self.manager(ha) + asyncio.run(manager.answer_camera({'inbox': 'text.hall_tile_settings', 'entity': 'media_player.office', 'size': '160', 'bg': 'E7E7E7'})) + self.assertEqual(ha.sent, []) + + +if __name__ == '__main__': + unittest.main()