Add GxEPD2_310_GDEQ031T10 (310_gdeq031t10) mono panel descriptor

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

components/gxepd2/display.py

@@ -112,6 +112,7 @@ PANELS = {
     "GxEPD2_290_T5": Panel("PANEL_290_T5", "TODO", "IL0373", "mono", "structural"),
     "GxEPD2_290_T94": Panel("PANEL_290_T94", "GDEM029T94", "TODO", "mono", "structural"),
     "GxEPD2_290_T94_V2": Panel("PANEL_290_T94_V2", "GDEM029T94", "TODO", "mono", "structural"),
+    "GxEPD2_310_GDEQ031T10": Panel("PANEL_310_GDEQ031T10", "GDEQ031T10", "UC8253", "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_310_gdeq031t10.h"
 #include "panel_290_t94_v2.h"
 #include "panel_290_t94.h"
 #include "panel_290_t5.h"

components/gxepd2/panel_310_gdeq031t10.h

@@ -0,0 +1,74 @@
+// GENERATED by emit_descriptor from GxEPD2_310_GDEQ031T10 - 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 EpdCommand PANEL_310_GDEQ031T10_INIT[] = {
+};
+
+inline const uint8_t PANEL_310_GDEQ031T10_WINDOW_SEQ0_0_00[] = {0x1E, 0x0D};
+inline const uint8_t PANEL_310_GDEQ031T10_WINDOW_SEQ0_1_00[] = {0x1F, 0x0D};
+inline const uint8_t PANEL_310_GDEQ031T10_WINDOW_SEQ0_3_90[] = {0x00, 0xEF, 0x00, 0x00, 0x01, 0x3F, 0x01};
+
+inline const EpdCommand PANEL_310_GDEQ031T10_WINDOW_SEQ0[] = {
+    {0x00, PANEL_310_GDEQ031T10_WINDOW_SEQ0_0_00, 2, /*delay_before_ms=*/0, /*delay_after_ms=*/1, /*wait_busy_after=*/false},
+    {0x00, PANEL_310_GDEQ031T10_WINDOW_SEQ0_1_00, 2},
+    {0x91, nullptr, 0},
+    {0x90, PANEL_310_GDEQ031T10_WINDOW_SEQ0_3_90, 7},
+};
+
+inline const uint8_t PANEL_310_GDEQ031T10_REFRESH_1_E0[] = {0x02};
+inline const uint8_t PANEL_310_GDEQ031T10_REFRESH_2_E5[] = {0x5A};
+inline const uint8_t PANEL_310_GDEQ031T10_REFRESH_3_50[] = {0x97};
+
+inline const EpdCommand PANEL_310_GDEQ031T10_REFRESH[] = {
+    {0x92, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/1, /*wait_busy_after=*/false},
+    {0xE0, PANEL_310_GDEQ031T10_REFRESH_1_E0, 1},
+    {0xE5, PANEL_310_GDEQ031T10_REFRESH_2_E5, 1},
+    {0x50, PANEL_310_GDEQ031T10_REFRESH_3_50, 1},
+    {0x04, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+    {0x12, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+};
+
+
+inline const EpdCommand PANEL_310_GDEQ031T10_POWER_OFF[] = {
+    {0x02, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+};
+
+inline const uint8_t PANEL_310_GDEQ031T10_HIBERNATE_0_07[] = {0xA5};
+
+inline const EpdCommand PANEL_310_GDEQ031T10_HIBERNATE[] = {
+    {0x07, PANEL_310_GDEQ031T10_HIBERNATE_0_07, 1},
+};
+
+inline const EpdPanelDescriptor PANEL_310_GDEQ031T10 = {
+    .width = 240,
+    .height = 320,
+    .busy_active_level = false,
+    .busy_timeout_ms = 15000,  // generous diagnostic ceiling (vendor full_refresh_time 1100ms, 1bpp mono/3-colour class); dev-tunable
+    .init_sequence = PANEL_310_GDEQ031T10_INIT,
+    .init_sequence_len = sizeof(PANEL_310_GDEQ031T10_INIT) / sizeof(PANEL_310_GDEQ031T10_INIT[0]),
+    .window_sequence = {PANEL_310_GDEQ031T10_WINDOW_SEQ0, nullptr},
+    .window_sequence_len = {sizeof(PANEL_310_GDEQ031T10_WINDOW_SEQ0) / sizeof(PANEL_310_GDEQ031T10_WINDOW_SEQ0[0]), 0},
+    .plane_count = 1,
+    .plane_write_cmd = {0x13, 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_310_GDEQ031T10_REFRESH,
+    .refresh_sequence_len = sizeof(PANEL_310_GDEQ031T10_REFRESH) / sizeof(PANEL_310_GDEQ031T10_REFRESH[0]),
+    .power_off_sequence = PANEL_310_GDEQ031T10_POWER_OFF,  // probe: powerOff(), fresh session after a normal refresh
+    .power_off_sequence_len = sizeof(PANEL_310_GDEQ031T10_POWER_OFF) / sizeof(PANEL_310_GDEQ031T10_POWER_OFF[0]),
+    .hibernate_sequence = PANEL_310_GDEQ031T10_HIBERNATE,  // probe: hibernate()'s tail past powerOff() (see file header)
+    .hibernate_sequence_len = sizeof(PANEL_310_GDEQ031T10_HIBERNATE) / sizeof(PANEL_310_GDEQ031T10_HIBERNATE[0]),
+};
+
+}  // namespace esphome::gxepd2