ESP32 墨水屏第一次刷新：选对控制器和驱动类

arduino-cli compile --fqbn 'esp32:esp32:esp32s3:FlashSize=8M,PSRAM=opi,FlashMode=qio,PartitionScheme=default_8MB,CDCOnBoot=default,USBMode=hwcdc' --build-path /tmp/d04-build .
arduino-cli upload --fqbn 'esp32:esp32:esp32s3:FlashSize=8M,PSRAM=opi,FlashMode=qio,PartitionScheme=default_8MB,CDCOnBoot=default,USBMode=hwcdc' -p /dev/cu.YOUR_UART_PORT --input-dir /tmp/d04-build

// ---- BusyBudget.h ----
// SPDX-License-Identifier: MIT
#pragma once
#include <stdint.h>
struct BusyBudget {
 static constexpr uint32_t limitMs=8000;
 uint32_t started=0;bool active=false;bool fault=false;
 void begin(uint32_t now){started=now;active=true;fault=false;}
 void observe(uint32_t now,bool busy){if(active&&busy&&uint32_t(now-started)>=limitMs)fault=true;}
 bool finish(uint32_t now,bool busy){observe(now,busy);active=false;if(busy)fault=true;return !fault;}
};
inline bool refresh_due(uint32_t now,uint32_t last,bool attempted){return !attempted||uint32_t(now-last)>=180000;}
// ---- esp32-epaper-first-refresh.ino ----
// SPDX-License-Identifier: MIT
#include <Arduino.h>
#include <SPI.h>
#include <GxEPD2_BW.h>
#include <gdey/GxEPD2_213_GDEY0213B74.h>
#include "BusyBudget.h"
// Good Display GDEY0213B74 + DESPI-C02 (2.2/0.47 ohm variant, P3=2.2 ohm).
constexpr int PIN_SCK=12,PIN_MOSI=11,PIN_CS=5,PIN_DC=4,PIN_RST=6,PIN_BUSY=10;
SPIClass epdSPI(FSPI);
GxEPD2_BW<GxEPD2_213_GDEY0213B74,GxEPD2_213_GDEY0213B74::HEIGHT>
 display(GxEPD2_213_GDEY0213B74(PIN_CS,PIN_DC,PIN_RST,PIN_BUSY));
BusyBudget budget;
bool attempted=false,halted=false;
uint32_t lastAttempt=0,sequence=0;
void busyCallback(const void*){
 budget.observe(millis(),digitalRead(PIN_BUSY)==HIGH);
 delay(1); // callback only observes; GxEPD2 owns its wait loop and timeout.
}
bool preflight(){
 uint32_t start=millis();
 while(digitalRead(PIN_BUSY)==HIGH&&uint32_t(millis()-start)<2000)delay(1);
 return digitalRead(PIN_BUSY)==LOW;
}
void fullRefresh(){
 if(halted){Serial.println("HALTED: power off, repair, then restart");return;}
 if(!refresh_due(millis(),lastAttempt,attempted)){Serial.println("WAIT: 180 s between attempts");return;}
 if(!preflight()){halted=true;Serial.println("STOP: BUSY high before call; no display transaction started");return;}
 attempted=true;lastAttempt=millis();++sequence;
 budget.begin(millis());
 // Reset pulse 10 ms for DESPI-C02. Re-init after hibernate; initial=true.
 display.init(115200,true,10,false);
 display.setRotation(1); // visible canvas 250 x 122; controller RAM 128 x 250.
 display.setFullWindow();
 Serial.printf("BEGIN full-window sequence=%lu canvas=%dx%d\n",(unsigned long)sequence,display.width(),display.height());
 display.firstPage();
 do{
  display.fillScreen(GxEPD_WHITE);
  display.drawRect(0,0,display.width(),display.height(),GxEPD_BLACK);
  display.fillRect(8,8,30,30,GxEPD_BLACK);
  display.drawRect(display.width()-38,8,30,30,GxEPD_BLACK);
  display.setTextColor(GxEPD_BLACK);display.setTextSize(1);
  display.setCursor(48,14);display.print("GDEY0213B74");
  display.setCursor(48,29);display.print("SSD1680 / FULL WINDOW");
  display.setCursor(8,53);display.print("BLACK  WHITE  BORDER");
  display.setCursor(8,70);display.print("SEQ ");display.print(sequence);
  display.setCursor(8,88);display.print("CALL RETURN != OPTICAL PASS");
  display.setCursor(8,105);display.print("250 x 122 / ROTATION 1");
 }while(display.nextPage());
 if(!budget.finish(millis(),digitalRead(PIN_BUSY)==HIGH)){
  halted=true;
  Serial.println("STOP: busy budget/level fault; driver call has returned; no hibernate or further display calls");
  return;
 }
 Serial.println("CALL_RETURNED_BUSY_LOW: inspect screen and record; no optical verification");
 budget.begin(millis());display.hibernate();
 if(!budget.finish(millis(),digitalRead(PIN_BUSY)==HIGH)){
  halted=true;Serial.println("STOP: hibernate call returned with fault; power off and repair");return;
 }
 Serial.println("HIBERNATE_CALL_RETURNED: MCU and board still powered; no current measurement");
}
void setup(){
 Serial.begin(115200);delay(300);
 pinMode(PIN_BUSY,INPUT); // external 10k pull-up on MCU side of optional BUSY SPST.
 digitalWrite(PIN_CS,HIGH);pinMode(PIN_CS,OUTPUT);
 if(!epdSPI.begin(PIN_SCK,-1,PIN_MOSI,PIN_CS)){halted=true;Serial.println("STOP: SPI begin failed");return;}
 display.epd2.selectSPI(epdSPI,SPISettings(4000000,MSBFIRST,SPI_MODE0));
 display.epd2.setBusyCallback(busyCallback);
 Serial.println("D04 ready; verify panel ID, then send r for full-window refresh. No auto refresh.");
}
void loop(){
 if(Serial.available()){char c=Serial.read();if(c=='r'||c=='R')fullRefresh();}
 delay(1);
}