Add GxEPD2_290 (290) mono panel descriptor

Autonomous capture-pipeline run; structural, not bench-verified.

components/gxepd2/display.py

@@ -103,6 +103,7 @@ PANELS = {
     "GxEPD2_260": Panel("PANEL_260", "GDEW026T0", "IL0373", "mono", "structural"),
     "GxEPD2_260_M01": Panel("PANEL_260_M01", "TODO", "UC8151", "mono", "structural"),
     "GxEPD2_270_GDEY027T91": Panel("PANEL_270_GDEY027T91", "GDEY027T91", "TODO", "mono", "structural"),
+    "GxEPD2_290": Panel("PANEL_290", "TODO", "IL3820", "mono", "structural"),
     # Diagnostic variant: the 396x272 master region as a self-contained panel.
     "GxEPD2_579c_GDEY0579F51_MASTER_ONLY": Panel(
         "PANEL_579C_GDEY0579F51_MASTER_ONLY", "GDEY0579F51", "HX8717", "4-color", "diagnostic"),

components/gxepd2/gxepd2_display.h

@@ -5,6 +5,7 @@
 #include "esphome/components/display/display_buffer.h"
 #include "esphome/components/spi/spi.h"
 #include "cycle_engine.h"
+#include "panel_290.h"
 #include "panel_270_gdey027t91.h"
 #include "panel_260_m01.h"
 #include "panel_260.h"

components/gxepd2/panel_290.h

@@ -0,0 +1,96 @@
+// GENERATED by emit_descriptor from GxEPD2_290 - candidate.
+// Command sequences, plane layout and plane_invert are observed here;
+// for a packed panel bits_per_pixel/palette/blank_code are probe-filled
+// when the colour family is recognised (4-colour/7-colour), else left TODO. A
+// dual-region panel also gets plane_width and a candidate line_order; the
+// exact PAIRED_EDGES row order still wants diag/driver confirmation.
+#pragma once
+#include "epd_command.h"
+
+namespace esphome::gxepd2 {
+
+inline const uint8_t PANEL_290_INIT_0_01[] = {0x27, 0x01, 0x00};
+inline const uint8_t PANEL_290_INIT_1_0C[] = {0xD7, 0xD6, 0x9D};
+inline const uint8_t PANEL_290_INIT_2_2C[] = {0xA8};
+inline const uint8_t PANEL_290_INIT_3_3A[] = {0x1A};
+inline const uint8_t PANEL_290_INIT_4_3B[] = {0x08};
+
+inline const EpdCommand PANEL_290_INIT[] = {
+    {0x01, PANEL_290_INIT_0_01, 3},
+    {0x0C, PANEL_290_INIT_1_0C, 3},
+    {0x2C, PANEL_290_INIT_2_2C, 1},
+    {0x3A, PANEL_290_INIT_3_3A, 1},
+    {0x3B, PANEL_290_INIT_4_3B, 1},
+};
+
+inline const uint8_t PANEL_290_WINDOW_SEQ0_0_11[] = {0x03};
+inline const uint8_t PANEL_290_WINDOW_SEQ0_1_44[] = {0x00, 0x0F};
+inline const uint8_t PANEL_290_WINDOW_SEQ0_2_45[] = {0x00, 0x00, 0x27, 0x01};
+inline const uint8_t PANEL_290_WINDOW_SEQ0_3_4E[] = {0x00};
+inline const uint8_t PANEL_290_WINDOW_SEQ0_4_4F[] = {0x00, 0x00};
+
+inline const EpdCommand PANEL_290_WINDOW_SEQ0[] = {
+    {0x11, PANEL_290_WINDOW_SEQ0_0_11, 1},
+    {0x44, PANEL_290_WINDOW_SEQ0_1_44, 2},
+    {0x45, PANEL_290_WINDOW_SEQ0_2_45, 4},
+    {0x4E, PANEL_290_WINDOW_SEQ0_3_4E, 1},
+    {0x4F, PANEL_290_WINDOW_SEQ0_4_4F, 2},
+};
+
+inline const uint8_t PANEL_290_REFRESH_0_01[] = {0x27, 0x01, 0x00};
+inline const uint8_t PANEL_290_REFRESH_1_0C[] = {0xD7, 0xD6, 0x9D};
+inline const uint8_t PANEL_290_REFRESH_2_2C[] = {0xA8};
+inline const uint8_t PANEL_290_REFRESH_3_3A[] = {0x1A};
+inline const uint8_t PANEL_290_REFRESH_4_3B[] = {0x08};
+inline const uint8_t PANEL_290_REFRESH_5_32[] = {0x50, 0xAA, 0x55, 0xAA, 0x11, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0x1F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_290_REFRESH_6_22[] = {0xC4};
+
+inline const EpdCommand PANEL_290_REFRESH[] = {
+    {0x01, PANEL_290_REFRESH_0_01, 3},
+    {0x0C, PANEL_290_REFRESH_1_0C, 3},
+    {0x2C, PANEL_290_REFRESH_2_2C, 1},
+    {0x3A, PANEL_290_REFRESH_3_3A, 1},
+    {0x3B, PANEL_290_REFRESH_4_3B, 1},
+    {0x32, PANEL_290_REFRESH_5_32, 30},
+    {0x22, PANEL_290_REFRESH_6_22, 1},
+    {0x20, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+    {0xFF, nullptr, 0},
+};
+
+inline const uint8_t PANEL_290_POWER_OFF_0_22[] = {0xC3};
+
+inline const EpdCommand PANEL_290_POWER_OFF[] = {
+    {0x22, PANEL_290_POWER_OFF_0_22, 1},
+    {0x20, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+};
+
+inline const uint8_t PANEL_290_HIBERNATE_0_10[] = {0x01};
+
+inline const EpdCommand PANEL_290_HIBERNATE[] = {
+    {0x10, PANEL_290_HIBERNATE_0_10, 1},
+};
+
+inline const EpdPanelDescriptor PANEL_290 = {
+    .width = 128,
+    .height = 296,
+    .busy_active_level = true,
+    .busy_timeout_ms = 15000,  // generous diagnostic ceiling (vendor full_refresh_time 1600ms, 1bpp mono/3-colour class); dev-tunable
+    .init_sequence = PANEL_290_INIT,
+    .init_sequence_len = sizeof(PANEL_290_INIT) / sizeof(PANEL_290_INIT[0]),
+    .window_sequence = {PANEL_290_WINDOW_SEQ0, nullptr},
+    .window_sequence_len = {sizeof(PANEL_290_WINDOW_SEQ0) / sizeof(PANEL_290_WINDOW_SEQ0[0]), 0},
+    .plane_count = 1,
+    .plane_write_cmd = {0x24, 0x00},
+    .plane_invert = {false, false},  // probe-derived
+    .bits_per_pixel = 1,  // probe: white fill => all-bits wire byte 0xFF
+    .palette = nullptr,
+    .palette_len = 0,
+    .refresh_sequence = PANEL_290_REFRESH,
+    .refresh_sequence_len = sizeof(PANEL_290_REFRESH) / sizeof(PANEL_290_REFRESH[0]),
+    .power_off_sequence = PANEL_290_POWER_OFF,  // probe: powerOff(), fresh session after a normal refresh
+    .power_off_sequence_len = sizeof(PANEL_290_POWER_OFF) / sizeof(PANEL_290_POWER_OFF[0]),
+    .hibernate_sequence = PANEL_290_HIBERNATE,  // probe: hibernate()'s tail past powerOff() (see file header)
+    .hibernate_sequence_len = sizeof(PANEL_290_HIBERNATE) / sizeof(PANEL_290_HIBERNATE[0]),
+};
+
+}  // namespace esphome::gxepd2