Add GxEPD2_420_SE0420NQ04 (420_se0420nq04) mono panel descriptor

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

components/gxepd2/display.py

@@ -119,6 +119,7 @@ PANELS = {
     "GxEPD2_420_GDEY042T81": Panel("PANEL_420_GDEY042T81", "GDEY042T81", "TODO", "mono", "structural"),
     "GxEPD2_420_GYE042A87": Panel("PANEL_420_GYE042A87", "TODO", "TODO", "mono", "structural"),
     "GxEPD2_420_M01": Panel("PANEL_420_M01", "TODO", "UC8176", "mono", "structural"),
+    "GxEPD2_420_SE0420NQ04": Panel("PANEL_420_SE0420NQ04", "TODO", "UC8276C", "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_420_se0420nq04.h"
 #include "panel_420_m01.h"
 #include "panel_420_gye042a87.h"
 #include "panel_420_gdey042t81.h"

components/gxepd2/panel_420_se0420nq04.h

@@ -0,0 +1,122 @@
+// GENERATED by emit_descriptor from GxEPD2_420_SE0420NQ04 - 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_420_SE0420NQ04_INIT_0_00[] = {0x3F, 0xCA};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_1_01[] = {0x03, 0x10, 0x3F, 0x3F, 0x03};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_2_06[] = {0xE7, 0xE7, 0x3D};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_3_60[] = {0x22};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_4_82[] = {0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_5_30[] = {0x09};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_6_E3[] = {0x88};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_7_61[] = {0x01, 0x90, 0x01, 0x2C};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_8_50[] = {0xB7};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_9_20[] = {0x01, 0x19, 0x01, 0x04, 0x19, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_10_21[] = {0x01, 0x19, 0x81, 0x44, 0x19, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_11_22[] = {0x01, 0x99, 0x81, 0x44, 0x59, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_12_23[] = {0x01, 0x59, 0x41, 0x84, 0x99, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_13_24[] = {0x01, 0x19, 0x41, 0x84, 0x19, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_INIT_14_50[] = {0x37};
+
+inline const EpdCommand PANEL_420_SE0420NQ04_INIT[] = {
+    {0x00, PANEL_420_SE0420NQ04_INIT_0_00, 2},
+    {0x01, PANEL_420_SE0420NQ04_INIT_1_01, 5},
+    {0x06, PANEL_420_SE0420NQ04_INIT_2_06, 3},
+    {0x60, PANEL_420_SE0420NQ04_INIT_3_60, 1},
+    {0x82, PANEL_420_SE0420NQ04_INIT_4_82, 1},
+    {0x30, PANEL_420_SE0420NQ04_INIT_5_30, 1},
+    {0xE3, PANEL_420_SE0420NQ04_INIT_6_E3, 1},
+    {0x61, PANEL_420_SE0420NQ04_INIT_7_61, 4},
+    {0x50, PANEL_420_SE0420NQ04_INIT_8_50, 1},
+    {0x20, PANEL_420_SE0420NQ04_INIT_9_20, 56},
+    {0x21, PANEL_420_SE0420NQ04_INIT_10_21, 42},
+    {0x22, PANEL_420_SE0420NQ04_INIT_11_22, 56},
+    {0x23, PANEL_420_SE0420NQ04_INIT_12_23, 56},
+    {0x24, PANEL_420_SE0420NQ04_INIT_13_24, 56},
+    {0x50, PANEL_420_SE0420NQ04_INIT_14_50, 1},
+    {0x04, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+};
+
+inline const uint8_t PANEL_420_SE0420NQ04_WINDOW_SEQ0_1_90[] = {0x00, 0x00, 0x01, 0x8F, 0x00, 0x00, 0x01, 0x2B, 0x01};
+
+inline const EpdCommand PANEL_420_SE0420NQ04_WINDOW_SEQ0[] = {
+    {0x91, nullptr, 0},
+    {0x90, PANEL_420_SE0420NQ04_WINDOW_SEQ0_1_90, 9},
+};
+
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_1_00[] = {0x3F, 0xCA};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_2_01[] = {0x03, 0x10, 0x3F, 0x3F, 0x03};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_3_06[] = {0xE7, 0xE7, 0x3D};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_4_60[] = {0x22};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_5_82[] = {0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_6_30[] = {0x09};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_7_E3[] = {0x88};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_8_61[] = {0x01, 0x90, 0x01, 0x2C};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_9_50[] = {0xB7};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_10_20[] = {0x01, 0x08, 0x00, 0x00, 0x00, 0x02, 0x00, 0x01, 0x68, 0xA8, 0x00, 0x00, 0x01, 0x00, 0x01, 0x14, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x12, 0x12, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_11_21[] = {0x01, 0x48, 0x00, 0x00, 0x00, 0x02, 0x00, 0x01, 0xA8, 0x68, 0x00, 0x00, 0x01, 0x00, 0x01, 0x54, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x92, 0x92, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_12_22[] = {0x01, 0x48, 0x00, 0x00, 0x00, 0x02, 0x00, 0x01, 0xA8, 0x68, 0x00, 0x00, 0x01, 0x00, 0x01, 0x54, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x92, 0x92, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_13_23[] = {0x01, 0x88, 0x00, 0x00, 0x00, 0x02, 0x00, 0x01, 0xA8, 0x68, 0x00, 0x00, 0x01, 0x00, 0x01, 0x94, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x52, 0x52, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+inline const uint8_t PANEL_420_SE0420NQ04_REFRESH_14_24[] = {0x01, 0x88, 0x00, 0x00, 0x00, 0x02, 0x00, 0x01, 0xA8, 0x68, 0x00, 0x00, 0x01, 0x00, 0x01, 0x94, 0x00, 0x00, 0x00, 0x01, 0x00, 0x01, 0x52, 0x52, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+
+inline const EpdCommand PANEL_420_SE0420NQ04_REFRESH[] = {
+    {0x92, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/1, /*wait_busy_after=*/false},
+    {0x00, PANEL_420_SE0420NQ04_REFRESH_1_00, 2},
+    {0x01, PANEL_420_SE0420NQ04_REFRESH_2_01, 5},
+    {0x06, PANEL_420_SE0420NQ04_REFRESH_3_06, 3},
+    {0x60, PANEL_420_SE0420NQ04_REFRESH_4_60, 1},
+    {0x82, PANEL_420_SE0420NQ04_REFRESH_5_82, 1},
+    {0x30, PANEL_420_SE0420NQ04_REFRESH_6_30, 1},
+    {0xE3, PANEL_420_SE0420NQ04_REFRESH_7_E3, 1},
+    {0x61, PANEL_420_SE0420NQ04_REFRESH_8_61, 4},
+    {0x50, PANEL_420_SE0420NQ04_REFRESH_9_50, 1},
+    {0x20, PANEL_420_SE0420NQ04_REFRESH_10_20, 56},
+    {0x21, PANEL_420_SE0420NQ04_REFRESH_11_21, 42},
+    {0x22, PANEL_420_SE0420NQ04_REFRESH_12_22, 56},
+    {0x23, PANEL_420_SE0420NQ04_REFRESH_13_23, 56},
+    {0x24, PANEL_420_SE0420NQ04_REFRESH_14_24, 56},
+    {0x12, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+};
+
+
+inline const EpdCommand PANEL_420_SE0420NQ04_POWER_OFF[] = {
+    {0x02, nullptr, 0, /*delay_before_ms=*/0, /*delay_after_ms=*/0, /*wait_busy_after=*/true},
+};
+
+inline const uint8_t PANEL_420_SE0420NQ04_HIBERNATE_0_07[] = {0xA5};
+
+inline const EpdCommand PANEL_420_SE0420NQ04_HIBERNATE[] = {
+    {0x07, PANEL_420_SE0420NQ04_HIBERNATE_0_07, 1},
+};
+
+inline const EpdPanelDescriptor PANEL_420_SE0420NQ04 = {
+    .width = 400,
+    .height = 300,
+    .busy_active_level = false,
+    .busy_timeout_ms = 15000,  // generous diagnostic ceiling (vendor full_refresh_time 3200ms, 1bpp mono/3-colour class); dev-tunable
+    .init_sequence = PANEL_420_SE0420NQ04_INIT,
+    .init_sequence_len = sizeof(PANEL_420_SE0420NQ04_INIT) / sizeof(PANEL_420_SE0420NQ04_INIT[0]),
+    .window_sequence = {PANEL_420_SE0420NQ04_WINDOW_SEQ0, nullptr},
+    .window_sequence_len = {sizeof(PANEL_420_SE0420NQ04_WINDOW_SEQ0) / sizeof(PANEL_420_SE0420NQ04_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_420_SE0420NQ04_REFRESH,
+    .refresh_sequence_len = sizeof(PANEL_420_SE0420NQ04_REFRESH) / sizeof(PANEL_420_SE0420NQ04_REFRESH[0]),
+    .power_off_sequence = PANEL_420_SE0420NQ04_POWER_OFF,  // probe: powerOff(), fresh session after a normal refresh
+    .power_off_sequence_len = sizeof(PANEL_420_SE0420NQ04_POWER_OFF) / sizeof(PANEL_420_SE0420NQ04_POWER_OFF[0]),
+    .hibernate_sequence = PANEL_420_SE0420NQ04_HIBERNATE,  // probe: hibernate()'s tail past powerOff() (see file header)
+    .hibernate_sequence_len = sizeof(PANEL_420_SE0420NQ04_HIBERNATE) / sizeof(PANEL_420_SE0420NQ04_HIBERNATE[0]),
+};
+
+}  // namespace esphome::gxepd2