1. TFT-LCD 显示模块工程实践：基于 STM32F103C8T6 驱动 1.8 寸 ST7735 彩色屏

在嵌入式人机交互系统中，显示模块是信息输出的关键通道。继 OLED（单色、高对比度）之后，彩色 TFT-LCD 屏幕因其丰富的色彩表现力、适中的成本和成熟的驱动生态，成为中低端工业 HMI、便携设备及教学实验平台的主流选择。本节聚焦于一款典型的 1.8 寸 SPI 接口 TFT-LCD 模块，其核心驱动芯片为 ST7735（或兼容型号 ST7735S），分辨率为 128×160 像素（字幕中误记为 128×106，以硬件规格书与实际引脚定义为准）。该模块并非简单的“像素点阵”，而是一个集成了行列驱动、伽马校正、内存映射与串行接口逻辑的完整显示子系统。理解其工作原理与驱动方法，是构建可靠图形界面的基础。

1.1 硬件接口与电气特性解析

该模块采用标准四线 SPI（Serial Peripheral Interface）协议进行通信，这是在资源受限的 Cortex-M3 内核（如 STM32F103C8T6）上实现高速数据传输的最优解。其物理连接仅需 8 根导线，但每根导线承载着明确的时序与功能职责，任何一根接线错误都将导致初始化失败或显示异常。

引脚名称	功能描述	STM32F103C8T6 典型连接	电气特性
VCC	模块供电正极	3.3V 电源轨（非 5V！）	模块标称电压为 3.3V，虽部分设计可耐受 5V，但长期使用存在烧毁风险。必须由 MCU 的 3.3V LDO 或稳压器提供，严禁直接取自 USB 5V。
GND	电源与信号地	MCU GND	必须与 MCU 共地，形成完整的电流回路。
SCL / SCK	SPI 时钟线	PA5 (SPI1_SCK)	由 MCU 主机产生，频率通常配置为 10–20 MHz。高频可提升刷屏速度，但需确保信号完整性，过长走线易引发边沿畸变。
SDA / MOSI	SPI 主机输出/从机输入数据线	PA7 (SPI1_MOSI)	承载所有命令与像素数据。数据在 SCK 的上升沿（CPOL=0, CPHA=0）被采样。
CS	片选信号	PA4 (GPIO_Output)	低电平有效。MCU 通过拉低此线选中该 LCD 设备，允许多个 SPI 外设共享 SCK/MOSI 总线。
DC / RS	数据/命令选择线	PA6 (GPIO_Output)	关键控制线。高电平表示后续 SPI 传输的是 像素数据 ；低电平表示传输的是 寄存器命令 。驱动逻辑的核心即在于精确控制此线电平。
RST / RES	复位信号	PA0 (GPIO_Output)	低电平有效。用于硬件复位驱动芯片内部状态机。首次上电或异常后，必须执行一个完整的复位序列（通常为低电平保持 >10ms，再拉高）。
BLK / LED	背光控制线	PA1 (GPIO_PWM 或 GPIO_Output)	控制屏幕背光 LED 的亮灭与亮度。可接至 GPIO 直接开关，或接至 TIMx_CHy 输出 PWM 信号实现无级调光。

关键注意点 ：该模块的“3.3V”标称值是指其 逻辑电平与内部 IC 工作电压 ，而非整个模组的绝对耐压上限。其背光 LED 通常由独立的串联电阻限流，工作电流约 20–30mA。若将 VCC 直接接至 5V，虽可能短暂点亮，但会因内部 LDO 过热或驱动电路击穿而永久失效。所有 GPIO 引脚均需配置为推挽输出（PP），且上拉/下拉电阻应禁用，以避免干扰 SPI 通信电平。

1.2 色彩模型与像素数据格式：RGB565 的工程意义

TFT-LCD 的本质是“光阀”。每个像素点由红（R）、绿（G）、蓝（B）三个子像素构成，通过调节各自透光率（即亮度）来混合出人眼感知的色彩。这与 OLED 的自发光原理不同，LCD 依赖背光源，因此其色彩饱和度与对比度受背光均匀性制约。

在嵌入式系统中，色彩被数字化为离散的整数。最常用的格式是 RGB565 ，其命名规则直接揭示了数据结构：
* R (Red) ：占用 5 位（bit 15–11），取值范围 0–31。
* G (Green) ：占用 6 位（bit 10–5），取值范围 0–63。
* B (Blue) ：占用 5 位（bit 4–0），取值范围 0–31。

因此，一个完整的 RGB565 像素数据恰好占据 16 位（2 字节） ，其内存布局如下（高位在前，Big-Endian）：

Bit:   15 14 13 12 11 | 10 9 8 7 6 5 | 4 3 2 1 0
       R R R R R     | G G G G G G  | B B B B B

这种设计是资源与效果的精妙平衡：
* 为何 G 占 6 位？ 人眼对绿色光谱最为敏感，分配更多位数能显著提升色彩过渡的平滑度与图像观感，这是符合视觉生理学的工程优化。
* 为何不是 RGB888？ RGB888 需 24 位/像素，带宽与内存开销翻倍。对于 128×160 分辨率，一帧全屏缓冲区需 128 * 160 * 3 = 61,440 字节，远超 C8T6 仅 20KB 的 SRAM。而 RGB565 仅需 128 * 160 * 2 = 40,960 字节，在牺牲极少主观观感的前提下，将内存压力降低了 33%。
* 颜色计算示例 ：
* 白色 ：R=31, G=63, B=31 → 0b11111_111111_11111 → 0xFFFF
* 黑色 ：R=0, G=0, B=0 → 0b00000_000000_00000 → 0x0000
* 纯红色 ：R=31, G=0, B=0 → 0b11111_000000_00000 → 0xF800
* 纯绿色 ：R=0, G=63, B=0 → 0b00000_111111_00000 → 0x07E0
* 纯蓝色 ：R=0, G=0, B=31 → 0b00000_000000_11111 → 0x001F

在代码中，这些常量被定义为宏，既提高可读性，也便于后期维护：

#define WHITE   0xFFFF
#define BLACK   0x0000
#define RED     0xF800
#define GREEN   0x07E0
#define BLUE    0x001F
#define YELLOW  0xFFE0 // R=31, G=63, B=0
#define CYAN    0x07FF // R=0, G=63, B=31
#define MAGENTA 0xF81F // R=31, G=0, B=31

1.3 ST7735 初始化流程：从复位到就绪的时序艺术

ST7735 并非上电即用的“傻瓜”芯片。它内部包含复杂的显示控制器、GRAM（Graphics RAM）和时序发生器。一次成功的初始化，本质上是向其内部寄存器写入一系列特定的命令与参数，从而将其配置为预期的工作模式。这个过程严格遵循数据手册定义的时序，任何一步的遗漏或顺序错误都会导致屏幕无法点亮或显示错乱。

初始化流程可分为四个逻辑阶段：

阶段一：硬件复位与基础时序建立

1. 拉低 RST ：将 PA0 置为低电平，持续至少 10ms（通常延时 100ms 更稳妥）。
2. 拉高 RST ：释放 RST 引脚，使其上拉至高电平。此时芯片开始内部 PLL 锁定与寄存器复位，需等待约 120ms。
3. 发送软复位命令 0x01 ：通过 SPI 发送命令 0x01 ，触发芯片内部的软件复位，确保所有寄存器处于已知初始状态。

阶段二：显示功能与方向配置

1. 睡眠退出 0x11 ：唤醒屏幕，结束睡眠模式。
2. 等待 0x11 完成 0x80 ：发送 0x80 命令，指示芯片等待 0x11 命令完成，这是一个关键的同步点。
3. 设置显示方向 0x36 ：这是最关键的命令之一。其参数字节决定了屏幕的坐标系映射：
   • 0x00 ：竖屏，原点在左上角（默认）。
   • 0xC0 ：横屏，原点在左上角（常见于 1.8 寸屏，使 128 成为宽度，160 成为高度）。
   • 0xA0 ：横屏，原点在右上角（镜像）。
   • 0x60 ：竖屏，原点在左下角（倒置）。
   • 工程实践 ：在 lcd.h 中定义 #define LCD_WIDTH 128 和 #define LCD_HEIGHT 160 ，并在初始化函数中根据需求写入对应值，避免硬编码。
4. 设置颜色模式 0x3A ：写入 0x05 ，明确告知芯片后续像素数据为 16 位 RGB565 格式。此步不可省略，否则芯片可能以 18 位模式解析数据，导致严重色偏。

阶段三：伽马校正与显示使能

1. 设置伽马曲线 0xE0 , 0xE1 ：这两条命令分别写入正向与负向伽马校正表。ST7735 提供了多组预设，最常用的是 0x0F, 0x1A, 0x0F, 0x18, 0x2F, 0x28, 0x20, 0x22, 0x1F, 0x1B, 0x23, 0x37, 0x00, 0x07, 0x02, 0x10 （正向）与 0x0F, 0x1B, 0x0F, 0x17, 0x33, 0x2C, 0x29, 0x2E, 0x30, 0x30, 0x39, 0x3F, 0x00, 0x07, 0x03, 0x10 （负向）。这些数值是厂商针对该液晶面板光学特性的精细调校，直接决定色彩还原的准确性。
2. 设置显示窗口 0x2A , 0x2B ：定义 GRAM 的有效区域。 0x2A 后跟 4 字节（X 起始、X 结束的高/低字节）， 0x2B 后跟 4 字节（Y 起始、Y 结束的高/低字节）。对于全屏，通常设为 (0, 0) 到 (127, 159) 。
3. 打开显示 0x29 ：最终使能显示输出。至此，屏幕进入可操作状态。

阶段四：内存写入模式配置

1. 设置内存写入模式 0x36 ：再次发送 0x36 ，但这次是配置 GRAM 的写入指针移动方向。例如， 0xC0 表示写入一个像素后，指针自动向右移动；到达行尾则跳至下一行首。这决定了后续 0x2C （写 GRAM）命令的数据流走向。

整个初始化序列必须严格按照时序执行，并在关键命令后插入必要的延时（如 HAL_Delay(120) ），以确保芯片有足够时间完成内部操作。将此流程封装为 LCD_Init() 函数，是驱动库健壮性的基石。

2. 底层通信与像素操作：SPI 协议的精准实现

驱动 TFT-LCD 的核心，是将抽象的“画一个点”、“填满一块区域”等指令，转化为精确的 SPI 时序波形。这要求我们对 SPI 的底层操作有深刻理解，而非简单依赖 HAL 库的高级 API。

2.1 手动 SPI 位操作：为什么以及如何做

STM32 的 HAL 库提供了 HAL_SPI_Transmit() 函数，它能一次性发送一个字节或多个字节。然而，在 TFT-LCD 驱动中，我们经常需要发送 单个位（bit） 。原因在于：
* 命令与数据的混合 ：SPI 总线上，命令（Command）和数据（Data）共用同一根 MOSI 线。区分它们的唯一方式，就是通过 DC 线的电平。当 DC=0，接下来的 8 个 SPI 时钟周期传输的是一个命令字节；当 DC=1，接下来的 8 个周期传输的是一个数据字节。 HAL_SPI_Transmit() 是一个原子操作，它无法在传输过程中动态切换 DC 电平。
* 灵活性与确定性 ：手动位操作（Bit-Banging）让我们完全掌控每一个时钟周期，可以精确地在任意时刻拉高/拉低 DC 线，从而实现命令与数据的无缝切换。这对于调试、理解协议以及在 HAL 库不可用的裸机环境中至关重要。

以下是 LCD_WriteByte() 函数的实现，它完成了“发送一个字节”的核心任务：

void LCD_WriteByte(uint8_t data) {
    uint8_t i;
    for(i = 0; i < 8; i++) {
        // 在 SCK 下降沿准备数据
        if(data & 0x80) {
            HAL_GPIO_WritePin(GPIOA, GPIO_PIN_7, GPIO_PIN_SET); // SDA = 1
        } else {
            HAL_GPIO_WritePin(GPIOA, GPIO_PIN_7, GPIO_PIN_RESET); // SDA = 0
        }
        data <<= 1;

        // 在 SCK 上升沿采样（CPOL=0, CPHA=0）
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET); // SCK = 1
        // 适当延时，保证信号稳定
        __NOP(); __NOP();
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET); // SCK = 0
        __NOP(); __NOP();
    }
}

关键细节解析 ：
* 循环 8 次 ：处理一个字节的 8 位。
* data & 0x80 ：检查最高位（MSB）是否为 1。这是 Big-Endian 传输的标准做法，确保高位先发。
* data <<= 1 ：左移一位，为下一次循环准备新的最高位。
* SCK 时序 ：先拉高（上升沿），再拉低（下降沿）。数据必须在 SCK 下降沿后、下一个上升沿前稳定。 __NOP() 指令提供了微秒级的确定性延时，比 HAL_Delay() 更精确，适用于高速 SPI（>1MHz）。

2.2 命令与数据的分层封装

基于 LCD_WriteByte() ，我们可以构建更高一层的封装，以清晰地区分命令（Command）和数据（Data）的发送：

// 发送一个命令字节
void LCD_WriteCmd(uint8_t cmd) {
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_6, GPIO_PIN_RESET); // DC = 0, 表示命令
    LCD_WriteByte(cmd);
}

// 发送一个数据字节
void LCD_WriteData(uint8_t data) {
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_6, GPIO_PIN_SET); // DC = 1, 表示数据
    LCD_WriteByte(data);
}

// 发送一个 16 位数据（一个像素）
void LCD_WriteData_16Bit(uint16_t data) {
    LCD_WriteData(data >> 8); // 先发高字节
    LCD_WriteData(data & 0xFF); // 再发低字节
}

这种封装方式，将“通信协议”的细节（DC 线控制）与“业务逻辑”（发送什么内容）彻底分离。在初始化函数 LCD_Init() 中，我们只需调用 LCD_WriteCmd(0x36) 和 LCD_WriteData(0xC0) ，代码意图一目了然，可维护性极强。

2.3 像素级绘图：从点到面的几何抽象

有了可靠的通信层，我们便可以构建图形绘制函数。所有复杂图形（线、矩形、圆）最终都归结为对单个像素点的写入。

2.3.1 设置像素点 LCD_DrawPoint()

这是最基础的绘图单元。其核心是两步：
1. 设置地址窗口 ：向 ST7735 发送 0x2A 和 0x2B 命令，将 GRAM 的读写指针定位到目标坐标 (x, y) 。
2. 写入像素数据 ：发送 0x2C 命令，然后紧跟一个 16 位的 RGB565 颜色值。

void LCD_DrawPoint(uint16_t x, uint16_t y, uint16_t color) {
    // 1. 设置列地址（X 轴）
    LCD_WriteCmd(0x2A);
    LCD_WriteData(x >> 8);      // X 起始高字节
    LCD_WriteData(x & 0xFF);    // X 起始低字节
    LCD_WriteData((x+1) >> 8);  // X 结束高字节（单点，故为 x+1）
    LCD_WriteData((x+1) & 0xFF); // X 结束低字节

    // 2. 设置行地址（Y 轴）
    LCD_WriteCmd(0x2B);
    LCD_WriteData(y >> 8);      // Y 起始高字节
    LCD_WriteData(y & 0xFF);    // Y 起始低字节
    LCD_WriteData((y+1) >> 8);  // Y 结束高字节
    LCD_WriteData((y+1) & 0xFF); // Y 结束低字节

    // 3. 开始写入数据
    LCD_WriteCmd(0x2C);

    // 4. 写入一个像素的颜色
    LCD_WriteData_16Bit(color);
}

工程要点 ：
* 地址窗口的最小化 ：为绘制单个点，我们将窗口设置为 x 到 x+1 ， y 到 y+1 ，这样 0x2C 命令只会写入一个像素，效率最高。
* 边界检查 ：在实际项目中，应在函数入口添加 if (x >= LCD_WIDTH || y >= LCD_HEIGHT) return; ，防止越界访问导致不可预测行为。

2.3.2 填充矩形区域 LCD_FillRectangle()

填充是 GUI 的高频操作，例如清屏、绘制背景、按钮等。其效率远高于逐点绘制。

void LCD_FillRectangle(uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t color) {
    uint16_t i, j;
    uint32_t total_pixels = width * height;

    // 1. 设置地址窗口为整个填充区域
    LCD_WriteCmd(0x2A);
    LCD_WriteData(x >> 8);
    LCD_WriteData(x & 0xFF);
    LCD_WriteData((x + width - 1) >> 8);
    LCD_WriteData((x + width - 1) & 0xFF);

    LCD_WriteCmd(0x2B);
    LCD_WriteData(y >> 8);
    LCD_WriteData(y & 0xFF);
    LCD_WriteData((y + height - 1) >> 8);
    LCD_WriteData((y + height - 1) & 0xFF);

    // 2. 开始连续写入
    LCD_WriteCmd(0x2C);

    // 3. 连续写入 total_pixels 个像素
    for(i = 0; i < total_pixels; i++) {
        LCD_WriteData_16Bit(color);
    }
}

性能考量 ：此函数利用了 ST7735 的“自动地址递增”特性。一旦设置了窗口并发送 0x2C ，后续每写入一个 16 位数据，GRAM 的写指针就会自动递增，指向下一个像素位置。因此，一个 for 循环即可完成整个区域的填充，避免了重复设置地址窗口的巨大开销。对于 128×160 的全屏填充，此方法比逐点调用 LCD_DrawPoint() 快数百倍。

3. 文本与图像显示：从字模到像素的艺术转换

在嵌入式系统中，“显示文字”绝非调用一个 printf() 那般简单。它是一场跨越多个抽象层级的转换：从 Unicode 字符（如“你”）→ 字模数据（Font Data）→ 像素矩阵 → LCD 像素点。理解这一链条，是实现自定义字体与国际化显示的关键。

3.1 字模提取原理与工具链

字模（Font Glyph）是将一个字符的视觉形态，数字化为一个二维的二值（黑白）或灰度（多级）点阵。对于 TFT-LCD，我们通常使用 点阵字模 ，其大小决定了显示的清晰度与内存占用。

• 12×12, 16×16, 24×24, 32×32 ：这些数字代表字模的宽度与高度（单位：像素）。例如，一个 16×16 的“你”字，其字模就是一个 16 行 × 16 列的点阵，每个点用 1 位（bit）表示“亮”或“灭”。
• C51 格式 ：这是单片机开发中最常用的字模存储格式。它将一个字模的所有点，按行、从左到右、从上到下，紧密排列为连续的字节（byte）。每个字节的 8 位，对应一行中的 8 个点。如果一行不足 8 点，则高位补 0。

工具链：PCtoLCD2002（群魔软件）
1. 设置 ：选择“C51 格式”，取消“每行前缀”与“每行后缀”，只保留 {} 作为数组边界。选择“纵向取模，字节倒序”，这是 STM32 小端（Little-Endian）架构下最自然的取模方式。
2. 生成 ：输入汉字“你好世界”，选择 16×16 点阵，点击“生成字模”。软件输出类似以下 C 数组：
c const unsigned char gImage_ni[256] = { /* 256 字节数据 */ }; const unsigned char gImage_hao[256] = { /* 256 字节数据 */ }; const unsigned char gImage_shi[256] = { /* 256 字节数据 */ }; const unsigned char gImage_jie[256] = { /* 256 字节数据 */ };
3. 集成 ：将生成的数组粘贴到 lcd.h 或单独的 font.c 文件中，并在 lcd.h 中声明外部引用 extern const unsigned char gImage_ni[256]; 。

3.2 中文显示函数 LCD_ShowChinese()

该函数接收坐标 (x, y) 、待显示的汉字字符串（如 "你好" ）以及字体大小，其核心是查表与点阵渲染。

void LCD_ShowChinese(uint16_t x, uint16_t y, const char* str, uint8_t size, uint16_t fc, uint16_t bc) {
    uint8_t x0 = x, y0 = y;
    const unsigned char* font_ptr;
    uint16_t width, height;

    // 根据字体大小选择对应的字模数组和尺寸
    switch(size) {
        case 16:
            width = 16; height = 16;
            // 此处需一个映射表，将汉字映射到其字模数组地址
            // 实际工程中，常使用 GB2312 编码，通过查表获得偏移
            break;
        case 24:
            width = 24; height = 24;
            break;
        default:
            return;
    }

    while(*str) {
        // 简化版：假设 str 是 ASCII 字符，直接查表
        // 真实项目中，需先判断是 ASCII 还是 GB2312 双字节
        if(*str <= 0x7F) { // ASCII
            font_ptr = ascii_font_16x16[*str];
        } else { // GB2312，需取两个字节
            uint16_t code = (*str << 8) | *(str+1);
            font_ptr = get_gb2312_font_ptr(code); // 自定义查找函数
            str++; // 跳过下一个字节
        }

        // 渲染字模：遍历每一行
        for(uint8_t row = 0; row < height; row++) {
            uint8_t line_data = font_ptr[row];
            for(uint8_t col = 0; col < width; col++) {
                uint16_t pixel_x = x0 + col;
                uint16_t pixel_y = y0 + row;
                // 判断当前点是否为“亮”
                if(line_data & (0x80 >> (col % 8))) {
                    LCD_DrawPoint(pixel_x, pixel_y, fc); // 前景色
                } else {
                    LCD_DrawPoint(pixel_x, pixel_y, bc); // 背景色
                }
            }
        }

        x0 += width; // 移动到下一个字符的起始 X 坐标
        str++;
    }
}

核心挑战与解决方案 ：
* 双字节编码 ：中文 GB2312 编码是双字节，首字节范围 0xA1–0xFE ，次字节 0xA1–0xFE 。函数需识别并正确组合。
* 字模查找 ：一个 16×16 字模占 32 字节（16 行 × 2 字节/行）。一个包含 65536 个汉字的完整字库将达 2MB，远超 MCU 存储。因此，工程实践中采用 按需加载 策略：仅将项目中实际用到的汉字（如菜单项、提示语）的字模编译进固件。

3.3 图像显示：BMP 格式的解析与渲染

显示图片是 TFT-LCD 最炫酷的功能。我们通常使用未压缩的 BMP（Bitmap）格式，因其结构简单，易于解析。

BMP 文件头解析

一个标准的 16 位 BMP 文件，其文件头（14 字节）和信息头（40 字节）包含了关键元数据：
* bfOffBits （偏移 10）：图像数据在文件中的起始位置（字节）。
* biWidth , biHeight （偏移 18, 22）：图像的宽度与高度（像素）。
* biBitCount （偏移 28）：每像素位数，此处为 16 。
* biCompression （偏移 30）：压缩方式， 0 表示不压缩。

渲染流程

1. 加载图像数据 ：将 BMP 文件的像素数据部分（从 bfOffBits 开始）全部读入 MCU 的 RAM。对于一张 100×100 的图片，数据量为 100 * 100 * 2 = 20,000 字节，仍在 C8T6 的 SRAM 容量内。
2. 设置显示窗口 ：根据目标坐标 (x, y) 和图片尺寸 (width, height) ，调用 LCD_SetWindows() 设置 GRAM 地址窗口。
3. 逐行写入 ：BMP 的像素数据是 从下到上、从左到右 存储的（即第一行数据对应图片的最后一行）。因此，渲染时需从数据缓冲区的末尾开始，向上逐行写入：
   c uint8_t* img_ptr = image_buffer + (height - 1) * width * 2; // 指向最后一行的起始 for(int16_t y_img = height - 1; y_img >= 0; y_img--) { for(uint16_t x_img = 0; x_img < width; x_img++) { uint16_t pixel = *(uint16_t*)(img_ptr + x_img * 2); LCD_WriteData_16Bit(pixel); } img_ptr -= width * 2; // 指向上一行 }

工程实践 ：将图片数据直接以 C 数组形式（ const uint16_t img_doraemon[10000] = {...} ）嵌入固件，是最简单可靠的方案，避免了文件系统与 SD 卡驱动的复杂性。这正是视频中“多啦A梦”图片的实现方式。

4. 工程实践与调试技巧：从实验室到产品的跨越

一个能在实验室点亮的驱动，距离成为一个稳定可靠的产品组件，中间隔着无数个“坑”。以下是我在多个项目中踩过的、最具代表性的几个问题及其解决方案。

4.1 时序冲突：SPI 与 GPIO 操作的竞态

最隐蔽的 bug 往往源于时序。当 LCD_WriteByte() 中的 SCK 和 SDA GPIO 操作与 HAL_GPIO_WritePin() 的 HAL 库内部逻辑发生冲突时，可能导致 SCK 信号出现毛刺或丢失。

现象 ：屏幕偶尔显示花屏、部分区域颜色错乱，或初始化失败。
根源 ： HAL_GPIO_WritePin() 是一个相对耗时的函数，它内部有状态检查与寄存器读-修改-写操作。在高频 SPI（>10MHz）下，两次 HAL_GPIO_WritePin() 调用之间的间隔可能不足以让硬件稳定。
解决方案 ：使用 直接寄存器操作 替代 HAL 库函数，将 GPIO 操作降至最简：

// 直接操作 ODR 寄存器，最快
#define SCK_HIGH()   (GPIOA->BSRR = GPIO_BSRR_BS5)
#define SCK_LOW()    (GPIOA->BSRR = GPIO_BSRR_BR5)
#define SDA_HIGH()   (GPIOA->BSRR = GPIO_BSRR_BS7)
#define SDA_LOW()    (GPIOA->BSRR = GPIO_BSRR_BR7)

BSRR （Bit Set/Reset Register）寄存器允许我们用一条指令同时设置或清除一个引脚，无需读取-修改-写入，消除了竞态风险。

4.2 内存瓶颈：全屏缓冲区的取舍

C8T6 的 20KB SRAM 是宝贵的资源。为 128×160 的屏幕开辟一个完整的帧缓冲区（40KB），是绝对不可能的。我们必须在“性能”与“内存”之间做出权衡。

• 方案一：无缓冲（Direct Write） ：所有绘图函数（ DrawPoint , FillRectangle ）都直接向 LCD 发送命令与数据。优点是内存占用为零；缺点是刷新一帧全屏（40KB 数据）需要较长时间（约 200ms @ 20MHz SPI），动画卡顿。
• 方案二：局部缓冲（Partial Buffer） ：只为频繁更新的 UI 元素（如一个 64×32 的图标区域）开辟一个小缓冲区（4KB）。更新时先在 RAM 中绘制，再一次性刷到 LCD。这是最实用的折中方案。
• 方案三：DMA 加速（推荐） ：利用 STM32 的 SPI DMA 功能。将一整块像素数据（如一个图标）放入 RAM，然后启动 DMA 传输。CPU 可在 DMA 运行期间执行其他任务，极大提升系统响应性。这是专业产品中的首选。

4.3 电源噪声：背光对显示的干扰

一个常被忽视的细节是背光电路。背光 LED 的驱动电流（20–30mA）会在 PCB 的电源平面上产生瞬态噪声。如果 VCC/GND 走线不够粗，或滤波电容（尤其是靠近 LCD 模块的 100nF 陶瓷电容）缺失，此噪声会耦合到 LCD 的模拟参考电压（VCOM）上，导致屏幕出现水平滚动的细纹或闪烁。

诊断 ：用示波器观察 VCC 引脚，开启/关闭背光时，是否能看到明显的电压跌落或振铃。
解决 ：在 LCD 模块的 VCC 与 GND 引脚之间，就近焊接一个 10uF 的钽电容（或 22uF 的电解电容）与一个 100nF 的陶瓷电容并联。前者提供低频储能，后者滤除高频噪声。

我曾在一款工业温控仪项目中遇到此问题。当时屏幕在继电器吸合的瞬间会出现严重闪烁，排查了数日，最终发现是背光电容焊盘虚焊。重新焊接后，问题彻底消失。这提醒我们，硬件是软件的根基，再精妙的驱动算法也无法弥补一个糟糕的硬件设计。