3. EPD 硬件接口解析：SPI 接口时序、数据/命令控制、忙检测与复位时序

电子纸（EPD）显示驱动芯片与主控处理器之间的物理通信链路，是 FrameBuffer 驱动能够正常工作的硬件基础。本章将深入解析 EPD 硬件接口的四个核心要素：SPI 总线时序、数据/命令（D/C#）控制、忙检测（Busy）引脚以及复位（RST）时序。理解这些接口的电气特性和时序要求，是编写稳定、高效的 EPD 驱动的第一步。

3.1 EPD 硬件接口架构概览

典型的 EPD 模组与主控 SoC 之间的连接，通常包含以下信号线：

3.2 SPI 接口时序详解

EPD 驱动芯片通常支持 SPI Mode 0（CPOL=0, CPHA=0）或 SPI Mode 3（CPOL=1, CPHA=1）。在 Mode 0 下，时钟空闲时为低电平，数据在时钟上升沿采样；在 Mode 3 下，时钟空闲时为高电平，数据在时钟上升沿采样。绝大多数 EPD 驱动芯片默认使用 SPI Mode 0。

3.2.1 SPI 时序参数要求

不同 EPD 驱动芯片对 SPI 时钟频率和时序有严格要求。以下为常见芯片的典型参数：

3.3 数据/命令控制（D/C# 引脚）

D/C# 引脚是 EPD 驱动芯片区分 SPI 总线上传输的是 命令 还是 数据 的关键信号。其逻辑电平定义如下：

• 低电平（0）：表示当前 SPI 传输的是 命令（Command），例如初始化配置、寄存器写入、刷新触发等。
• 高电平（1）：表示当前 SPI 传输的是 数据（Data），例如图像像素数据、查找表（LUT）内容等。

3.3.1 命令/数据发送流程

在驱动中，发送命令和数据的典型流程如下：

1. 拉低 CS#：选中 EPD 芯片。
2. 设置 D/C# 为低电平：指示接下来发送的是命令。
3. 通过 SPI 发送命令字节：例如 0x01（软件复位）或 0x10（写入配置）。
4. 设置 D/C# 为高电平：指示接下来发送的是数据。
5. 通过 SPI 发送数据字节：例如配置参数或图像数据。
6. 拉高 CS#：结束本次通信。

/* 发送命令 */
static void epd_send_command(struct spi_device *spi, uint8_t cmd)
{
    /* 设置 D/C# 为低电平（命令模式） */
    gpiod_set_value(epd->dc_gpio, 0);
    /* 发送命令字节 */
    spi_write(spi, &cmd, 1);
}

/* 发送数据 */
static void epd_send_data(struct spi_device *spi, const uint8_t *data, size_t len)
{
    /* 设置 D/C# 为高电平（数据模式） */
    gpiod_set_value(epd->dc_gpio, 1);
    /* 发送数据 */
    spi_write(spi, data, len);
}

3.4 忙检测（Busy 引脚）

EPD 驱动芯片在执行内部操作（如刷新显示、初始化、查找表加载）时，会通过 BUSY 引脚向主控报告其工作状态。正确使用忙检测是防止驱动向芯片发送无效命令、避免通信冲突的关键。

3.4.1 Busy 引脚电平定义

3.4.2 忙检测实现策略

在驱动中，忙检测通常采用 轮询（Polling） 或 中断（Interrupt） 两种方式：

• 轮询方式：在发送命令后，循环读取 BUSY 引脚电平，直到检测到低电平。适用于简单场景，但会占用 CPU。
• 中断方式：将 BUSY 引脚配置为上升沿/下降沿触发的中断，在中断处理函数中唤醒等待队列。效率更高，适合多任务系统。

/* 轮询等待芯片空闲，带超时 */
static int epd_wait_idle(struct epd_device *epd, unsigned long timeout_ms)
{
    unsigned long timeout = jiffies + msecs_to_jiffies(timeout_ms);

    while (time_before(jiffies, timeout)) {
        if (gpiod_get_value(epd->busy_gpio) == 0) {
            return 0; /* 芯片空闲 */
        }
        usleep_range(1000, 2000); /* 每 1-2ms 轮询一次 */
    }
    dev_err(&epd->spi->dev, "Busy wait timeout!\n");
    return -ETIMEDOUT;
}

3.5 复位时序（RST# 引脚）

硬件复位是 EPD 驱动芯片初始化的第一步。正确的复位时序可以确保芯片内部状态机、寄存器和存储器处于已知的初始状态。

3.5.1 复位时序要求

典型的 EPD 复位时序包含以下步骤：

1. 拉低 RST#：将复位引脚置为低电平，持续至少 10 µs（具体值参考芯片数据手册）。
2. 保持低电平：确保芯片内部复位逻辑完成。
3. 拉高 RST#：释放复位，芯片开始执行内部初始化。
4. 等待初始化完成：通过 BUSY 引脚检测芯片是否进入空闲状态。

3.6 接口调试常见问题与排查

在 EPD 驱动开发过程中，硬件接口问题是最常见的故障来源。以下为典型问题及排查方法：